Set default organization design
Mark this design as the organization's default. Clears any previous default.
Authentication: personal access token. The spec defines an api_key security
scheme — send an Authorization: ApiKey <your-personal-access-token> header
(value format: ApiKey <your key>). A session_cookie scheme (connect.sid)
exists for browser sessions. Operations in this spec declare security: [], an
artifact of the upstream spec generator — authentication is still enforced by the
server.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
designUuidOrSlug | string | Yes |
Responses
200 — Success
{
"results": {
"files": [
{
"createdAt": "2024-01-01T00:00:00.000Z",
"sizeBytes": 0,
"contentType": "string",
"filename": "string",
"kind": "instruction",
"fileUuid": "string"
}
],
"createdByUserUuid": "string",
"updatedAt": "2024-01-01T00:00:00.000Z",
"createdAt": "2024-01-01T00:00:00.000Z",
"isDefault": true,
"extraInstructions": "string",
"description": "string",
"name": "string",
"slug": "string",
"organizationUuid": "string",
"designUuid": "string"
},
"status": "ok"
}default — Error
{
"error": {
"data": "string",
"message": "string",
"name": "string",
"statusCode": 0
},
"status": "error"
}Clear default organization design
Clear whichever design is currently the organization default. Idempotent — succeeds when no default is set. NOTE: This literal `/default` route MUST stay registered before `Delete('/{designUuidOrSlug}')` below so Express routes a request to `DELETE /api/v1/org/designs/default` here rather than treating "default" as a `designUuidOrSlug` path param.
Upload file to organization design
Upload a file into a design. Send raw bytes as the body with the appropriate Content-Type and Content-Length headers. Pass `kind` and `filename` as query parameters. Mirrors the data-app image upload pattern — no multipart wrapping required.