List AI database runs in a workspace
Returns the workspace's plan and apply runs, optionally narrowed to a single database with the `databaseId` query parameter. Requires a workspace member with the `ai:read` permission.
Authorization
apiKey Workspace API key created in Workspace settings → API keys. Scopes on the key bound what it can read and write.
In: header
Path Parameters
Query Parameters
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/workspaces/string/ai/runs"{ "data": [ { "id": "string", "workspaceId": "string", "databaseId": "string", "prompt": "string", "summary": "string", "status": "planned", "ops": [ { "index": 0, "op": { "kind": "create_field", "key": "string", "label": "string", "fieldKind": "text", "required": true, "options": [ {} ], "settings": {}, "reciprocal": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "label": "string", "cardinality": "one" } }, "stake": "never_ask", "description": "string" } ], "maxStake": "never_ask", "createdAt": "string" } ]}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}{ "_tag": "ApiNotFound", "error": "not_found", "message": "That item does not exist, or this key cannot see it.", "status": 404}Read one AI database run
Returns a single run with its prompt, summary, status, planned operations, and highest stake. Requires a workspace member with the `ai:read` permission; an unknown or malformed run id is reported as not found.
List the AI artifacts in a workspace
Returns the workspace's artifacts newest first, optionally narrowed by `chatId`, `messageId`, `kind`, or `status`; archived artifacts are excluded unless `status` asks for them. Requires a workspace member with the `ai:read` permission, and an artifact whose referenced workspace item or file the caller cannot read is dropped from the page. Pass `limit` to cap the page size.