Runtime profiles

Operations of the Workspace Orchestrator API. Paths are relative to your deployment's API host.

GET /api/workspace-orchestrator-api/runtime-profiles

List RuntimeProfile identities owned by the caller owner space

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/workspace-orchestrator-api/runtime-profiles

Create a stable RuntimeProfile identity

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json CreateRuntimeProfileDto

GET /api/workspace-orchestrator-api/runtime-profiles/{resourceId}

Get a RuntimeProfile identity and its pointers

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/draft

Get the current RuntimeProfile draft

Authentication: bearer token (Authorization: Bearer <token>)

PUT /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/draft

Append a changed draft using optimistic concurrency

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json SaveRuntimeProfileDraftDto

GET /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/drafts

List the bounded recoverable draft ring

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/publish

Validate and publish the exact current draft as an immutable revision

Publication resolves the exact registered worker runtime and applies only its strict RuntimeProfile schema. Full composition compilation occurs later during session resolution.

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json PublishRuntimeProfileDto

GET /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/release-history

List immutable stable ReleaseSet history

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/retire

Retire the stable RuntimeProfile release

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json RetireRuntimeProfileDto

GET /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/revisions

List immutable RuntimeProfile revisions

Authentication: bearer token (Authorization: Bearer <token>)

GET /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/revisions/{revisionId}

Resolve and hash-verify one exact revision pin

Authentication: bearer token (Authorization: Bearer <token>)

POST /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/revisions/{revisionId}/restore

Restore an immutable revision as a new draft

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json RestoreRuntimeProfileRevisionDto

POST /api/workspace-orchestrator-api/runtime-profiles/{resourceId}/rollback

Roll stable back to an immutable prior ReleaseSet

Authentication: bearer token (Authorization: Bearer <token>)

Request body: application/json RollbackRuntimeProfileDto