rest api
the same primitives that power the ui, exposed as http. bring your own automation.
auth
bearer tokens. create one at /settings/tokens. scopes are read, write, run, admin.
Authorization: Bearer vs_live_xxxxxxxxxxxxxxxx
base url
https://api.vibestartup.pro/v1
files
GET /projects/:project/fs/*path read a file
PUT /projects/:project/fs/*path write a file
DELETE /projects/:project/fs/*path delete a file
GET /projects/:project/fs?glob=**/*.md glob
GET /projects/:project/fs/*path?versions=1 version list
write body can be raw bytes or json with { content, frontmatter } for typed files.
agents
GET /projects/:project/agents
POST /projects/:project/agents/:name/runs start a run
GET /projects/:project/runs/:id run status + transcript
DELETE /projects/:project/runs/:id cancel
the run response streams ndjson when you pass ?stream=1.
runners
GET /projects/:project/runners
POST /projects/:project/runners/:seat/suspend
POST /projects/:project/runners/:seat/wake
webhooks
POST /webhooks/:project/:name fire a webhook trigger
signed with hmac-sha256 using the shared secret from project settings.
rate limits
| scope | limit | |-------|-------| | read | 100 req/s | | write | 20 req/s | | run | 5 req/s |
429s include Retry-After.
openapi
full machine-readable spec at /v1/openapi.json when published. link will go here soon — right now the endpoints above are authoritative. yes this is the "link to openapi soon" lol.
sdks
@vibestartup/node— node/edge@vibestartup/python— python@vibestartup/go— go
install via your package manager of choice. they wrap the rest surface + handle auth + retries.