Busabase
OpenAPI Reference

Space instructions

Shared Markdown context (vision, mission, values, design style) that agents read at the start of every new task. Owners and admins update it with optimistic version checks; it never grants access.

GET
/api/v1/space-instructions

Shared team context: vision, mission, values, design style, and defaults. Read the latest version before finding task-specific playbooks. An empty body means no instructions are configured. Stored instructions do not override the user's explicit request or grant permissions.

Response Body

application/json

curl -X GET "https://example.com/api/v1/space-instructions"
{  "spaceId": "string",  "body": "string",  "version": 0,  "updatedAt": "2019-08-24T14:15:22Z"}
PUT
/api/v1/space-instructions

Replaces the shared Markdown body, preserving its text. Use the version from the latest GET as expectedVersion (0 when unconfigured). A concurrent edit returns CONFLICT without overwriting stored content. An empty body clears the instructions.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PUT "https://example.com/api/v1/space-instructions" \  -H "Content-Type: application/json" \  -d '{    "body": "string",    "expectedVersion": 0  }'
{  "spaceId": "string",  "body": "string",  "version": 0,  "updatedAt": "2019-08-24T14:15:22Z"}