Manage Bootspring projects.
Method Endpoint Description GET/projectsList all projects POST/projectsCreate a project GET/projects/:idGet a project PATCH/projects/:idUpdate a project DELETE/projects/:idDelete a project
1 {
2 "id" : "proj_abc123" ,
3 "name" : "My SaaS App" ,
4 "slug" : "my-saas-app" ,
5 "description" : "A SaaS application built with Next.js" ,
6 "type" : "web" ,
7 "framework" : "nextjs" ,
8 "status" : "active" ,
9 "settings" : {
10 "autoGenerateContext" : true ,
11 "defaultAgent" : "fullstack-expert" ,
12 "qualityGates" : [ "pre-commit" , "pre-push" ]
13 } ,
14 "stats" : {
15 "agentInvocations" : 156 ,
16 "skillsApplied" : 23 ,
17 "lastActivity" : "2024-01-15T10:30:00Z"
18 } ,
19 "createdAt" : "2024-01-01T00:00:00Z" ,
20 "updatedAt" : "2024-01-15T10:30:00Z"
21 }
Parameter Type Description pageinteger Page number (default: 1) per_pageinteger Items per page (default: 20, max: 100) statusstring Filter by status: active, archived sortstring Sort field: name, created_at, updated_at orderstring Sort order: asc, desc
curl https://api.bootspring.dev/v1/projects?status = active & sort = updated_at & order = desc \
-H "Authorization: Bearer bs_xxx"
1 {
2 "data" : [
3 {
4 "id" : "proj_abc123" ,
5 "name" : "My SaaS App" ,
6 "slug" : "my-saas-app" ,
7 "status" : "active" ,
8 "createdAt" : "2024-01-01T00:00:00Z" ,
9 "updatedAt" : "2024-01-15T10:30:00Z"
10 }
11 ] ,
12 "pagination" : {
13 "total" : 5 ,
14 "page" : 1 ,
15 "perPage" : 20 ,
16 "totalPages" : 1
17 }
18 }
Field Type Required Description namestring Yes Project name (2-100 chars) descriptionstring No Project description typestring No Project type (default: web) frameworkstring No Framework (e.g., nextjs, react) settingsobject No Project settings
1 curl -X POST https://api.bootspring.dev/v1/projects \
2 -H "Authorization: Bearer bs_xxx" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": "My New Project",
6 "description": "A new SaaS application",
7 "type": "web",
8 "framework": "nextjs",
9 "settings": {
10 "autoGenerateContext": true
11 }
12 }'
1 {
2 "data" : {
3 "id" : "proj_def456" ,
4 "name" : "My New Project" ,
5 "slug" : "my-new-project" ,
6 "description" : "A new SaaS application" ,
7 "type" : "web" ,
8 "framework" : "nextjs" ,
9 "status" : "active" ,
10 "settings" : {
11 "autoGenerateContext" : true ,
12 "defaultAgent" : null ,
13 "qualityGates" : [ ]
14 } ,
15 "stats" : {
16 "agentInvocations" : 0 ,
17 "skillsApplied" : 0 ,
18 "lastActivity" : null
19 } ,
20 "createdAt" : "2024-01-15T12:00:00Z" ,
21 "updatedAt" : "2024-01-15T12:00:00Z"
22 }
23 }
curl https://api.bootspring.dev/v1/projects/proj_abc123 \
-H "Authorization: Bearer bs_xxx"
Returns the full project object.
All fields are optional. Only include fields you want to update.
Field Type Description namestring Project name descriptionstring Project description statusstring Status: active, archived settingsobject Project settings (merged)
1 curl -X PATCH https://api.bootspring.dev/v1/projects/proj_abc123 \
2 -H "Authorization: Bearer bs_xxx" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "name": "Updated Project Name",
6 "settings": {
7 "defaultAgent": "backend-expert"
8 }
9 }'
Returns the updated project object.
curl -X DELETE https://api.bootspring.dev/v1/projects/proj_abc123 \
-H "Authorization: Bearer bs_xxx"
1 {
2 "data" : {
3 "deleted" : true ,
4 "id" : "proj_abc123"
5 }
6 }
Setting Type Default Description autoGenerateContextboolean true Auto-generate CLAUDE.md defaultAgentstring null Default agent for invocations qualityGatesarray [] Enabled quality gates notificationsobject {} Notification preferences
1 {
2 "settings" : {
3 "autoGenerateContext" : true ,
4 "defaultAgent" : "fullstack-expert" ,
5 "qualityGates" : [ "pre-commit" , "pre-push" , "pre-deploy" ] ,
6 "notifications" : {
7 "email" : true ,
8 "slack" : {
9 "enabled" : true ,
10 "channel" : "#dev-alerts"
11 }
12 }
13 }
14 }
Type Description webWeb application apiAPI/Backend service mobileMobile application cliCommand-line tool libraryLibrary/Package
Framework Description nextjsNext.js reactReact vueVue.js svelteSvelteKit expressExpress.js fastapiFastAPI djangoDjango railsRuby on Rails
Code Description project_not_foundProject doesn't exist project_limit_exceededPlan project limit reached slug_takenProject slug already exists invalid_frameworkUnknown framework