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.