DesignSystemBuilder

Operations of the Design System Builder API. Paths are relative to your deployment's API host.

GET /api/design-system-builder-api/design-system-builder

List design system builds

Authentication: none

POST /api/design-system-builder-api/design-system-builder

Create a design system build + provision its interactive agent

Authentication: none

Request body: application/json CreateDesignSystemBuilderDto

GET /api/design-system-builder-api/design-system-builder/{id}

Get a design system build by id

Authentication: none

PATCH /api/design-system-builder-api/design-system-builder/{id}

Update design system build metadata (title, description).

Authentication: none

Request body: application/json UpdateDesignSystemBuilderDto

DELETE /api/design-system-builder-api/design-system-builder/{id}

Archive a design system build (terminates its interactive session). Idempotent.

Authentication: none

POST /api/design-system-builder-api/design-system-builder/{id}/kb-push

Push selected files or directories from the design system build session to a knowledge-base space. Optionally creates the target space if createSpace=true. Directory entries are expanded recursively.

Authentication: none

Request body: application/json DesignSystemBuilderKBPushDto

POST /api/design-system-builder-api/design-system-builder/{id}/launch

Hand off selected session deliverables + deliverables/PIPELINE_INTENT.md to work-orchestrator-api as a clarification-driven bootstrap. Returns the bootstrap jobId the frontend uses to navigate into the clarification chat. Keeps the design system build ACTIVE so the user can iterate further.

Authentication: none

Request body: application/json LaunchPipelineDto

POST /api/design-system-builder-api/design-system-builder/{id}/publish

Publish this build's authored design system into the Template Registry as the organisation's. Reads deliverables/xema-design-system.json and nothing else, records the evaluation the chosen kind declares, freezes a revision and proposes publication. Returns 202: promotion blocks on a human answering a Decision, so a pending-decision status is this call SUCCEEDING, not failing.

Authentication: none

Request body: application/json PublishDesignSystemDto

POST /api/design-system-builder-api/design-system-builder/{id}/restart

Replace the interactive session backing this design system build. Used when the prior session has ended unrecoverably. The old session id is kept in previousSessionIds as an audit trail.

Authentication: none