{ "components": { "schemas": { "ArtifactRef": { "additionalProperties": false, "properties": { "artifact_id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "artifact_id", "name" ], "type": "object" }, "CreateExecutionRequest": { "additionalProperties": false, "properties": { "command": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "cwd": { "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "type": "object" }, "stdin": { "type": "string" }, "timeout_ms": { "format": "int64", "type": "integer" } }, "required": [ "command" ], "type": "object" }, "CreateMachineRequest": { "additionalProperties": false, "properties": { "autosleep": { "default": "300s", "description": "Idle window before autosleep. Accepts fixed duration units like 30s, 30m, 2h, 7d3h4s, or 1w3d, raw seconds (\"1800\"), or never to disable.", "type": "string" }, "memory_mib": { "default": 4096, "description": "Memory in MiB.", "exclusiveMinimum": 0, "format": "int64", "type": "integer" }, "storage_gib": { "default": 10, "description": "Storage in GiB.", "exclusiveMinimum": 0, "format": "int64", "type": "integer" }, "vcpu": { "default": 1, "description": "CPU in vCPUs.", "exclusiveMinimum": 0, "format": "double", "type": "number" } }, "type": "object" }, "CreateSSHSessionRequest": { "additionalProperties": false, "properties": { "public_key": { "type": "string" } }, "required": [ "public_key" ], "type": "object" }, "ErrorDetail": { "additionalProperties": false, "properties": { "location": { "description": "Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'", "type": "string" }, "message": { "description": "Error message text", "type": "string" }, "value": { "description": "The value at the given location" } }, "type": "object" }, "ErrorModel": { "additionalProperties": false, "properties": { "detail": { "description": "A human-readable explanation specific to this occurrence of the problem.", "examples": [ "Property foo is required but is missing." ], "type": "string" }, "errors": { "description": "Optional list of individual error details", "items": { "$ref": "#/components/schemas/ErrorDetail" }, "type": [ "array", "null" ] }, "instance": { "description": "A URI reference that identifies the specific occurrence of the problem.", "examples": [ "https://example.com/error-log/abc123" ], "format": "uri", "type": "string" }, "status": { "description": "HTTP status code", "examples": [ 400 ], "format": "int64", "type": "integer" }, "title": { "description": "A short, human-readable summary of the problem type. This value should not change between occurrences of the error.", "examples": [ "Bad Request" ], "type": "string" }, "type": { "default": "about:blank", "description": "A URI reference to human-readable documentation for the error.", "examples": [ "https://example.com/errors/example" ], "format": "uri", "type": "string" } }, "type": "object" }, "ExecutionEvent": { "additionalProperties": false, "properties": { "at": { "format": "date-time", "type": "string" }, "chunk": { "type": "string" }, "error_code": { "type": "string" }, "error_message": { "type": "string" }, "exit_code": { "format": "int64", "type": "integer" }, "sequence": { "format": "int64", "type": "integer" }, "signal": { "format": "int64", "type": "integer" }, "status": { "enum": [ "wake_in_progress", "queued", "running", "succeeded", "failed", "cancelled", "expired" ], "type": "string" }, "type": { "enum": [ "lifecycle", "stdout", "stderr" ], "type": "string" } }, "required": [ "sequence", "type", "at" ], "type": "object" }, "ExecutionEventsResponse": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/ExecutionEvent" }, "type": [ "array", "null" ] }, "next_cursor": { "type": "string" } }, "required": [ "items" ], "type": "object" }, "ExecutionListResponse": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/ExecutionResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "type": "string" } }, "required": [ "items" ], "type": "object" }, "ExecutionOutputResponse": { "additionalProperties": false, "properties": { "execution_id": { "type": "string" }, "stderr": { "type": "string" }, "stderr_bytes": { "format": "int64", "type": "integer" }, "stderr_truncated": { "type": "boolean" }, "stdout": { "type": "string" }, "stdout_bytes": { "format": "int64", "type": "integer" }, "stdout_truncated": { "type": "boolean" } }, "required": [ "execution_id" ], "type": "object" }, "ExecutionResponse": { "additionalProperties": false, "properties": { "artifacts": { "items": { "$ref": "#/components/schemas/ArtifactRef" }, "type": [ "array", "null" ] }, "command": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "completed_at": { "format": "date-time", "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "cwd": { "type": "string" }, "env_keys": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "error_code": { "type": "string" }, "error_message": { "type": "string" }, "execution_id": { "type": "string" }, "exit_code": { "format": "int64", "type": "integer" }, "expires_at": { "format": "date-time", "type": "string" }, "machine_id": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "signal": { "format": "int64", "type": "integer" }, "started_at": { "format": "date-time", "type": "string" }, "status": { "enum": [ "wake_in_progress", "queued", "running", "succeeded", "failed", "cancelled", "expired" ], "type": "string" }, "stderr_bytes": { "format": "int64", "type": "integer" }, "stderr_truncated": { "type": "boolean" }, "stdout_bytes": { "format": "int64", "type": "integer" }, "stdout_truncated": { "type": "boolean" } }, "required": [ "execution_id", "machine_id", "status", "command", "created_at" ], "type": "object" }, "LifecycleResponse": { "additionalProperties": false, "properties": { "autosleep_seconds": { "description": "Seconds of inactivity before autosleep. 0 disables autosleep.", "format": "int64", "maximum": 9223372036, "minimum": 0, "type": "integer" }, "desired_state": { "enum": [ "running", "sleeping", "destroyed" ], "type": "string" }, "machine_id": { "type": "string" }, "memory_mib": { "description": "Memory in MiB.", "format": "int64", "type": "integer" }, "phase": { "enum": [ "accepted", "placement_pending", "starting", "running", "stopping", "sleeping", "destroying", "destroyed", "failed" ], "type": "string" }, "storage_gib": { "format": "int64", "type": "integer" }, "vcpu": { "description": "CPU in vCPUs.", "format": "double", "type": "number" } }, "required": [ "machine_id", "vcpu", "memory_mib", "storage_gib", "autosleep_seconds", "desired_state", "phase" ], "type": "object" }, "LifecycleStatus": { "additionalProperties": false, "properties": { "last_error": { "type": "string" }, "last_progress_at": { "format": "date-time", "type": "string" }, "last_transition_at": { "format": "date-time", "type": "string" }, "phase": { "enum": [ "accepted", "placement_pending", "starting", "running", "stopping", "sleeping", "destroying", "destroyed", "failed" ], "type": "string" }, "reason": { "type": "string" }, "retryable": { "type": "boolean" }, "revision": { "type": "string" } }, "required": [ "phase", "reason", "retryable", "revision", "last_transition_at", "last_progress_at" ], "type": "object" }, "MachineDetailResponse": { "additionalProperties": false, "properties": { "autosleep_seconds": { "description": "Seconds of inactivity before autosleep. 0 disables autosleep.", "format": "int64", "maximum": 9223372036, "minimum": 0, "type": "integer" }, "desired_state": { "enum": [ "running", "sleeping", "destroyed" ], "type": "string" }, "machine_id": { "type": "string" }, "memory_mib": { "description": "Memory in MiB.", "format": "int64", "type": "integer" }, "status": { "$ref": "#/components/schemas/LifecycleStatus" }, "storage_gib": { "format": "int64", "type": "integer" }, "vcpu": { "description": "CPU in vCPUs.", "format": "double", "type": "number" } }, "required": [ "machine_id", "vcpu", "memory_mib", "storage_gib", "autosleep_seconds", "desired_state", "status" ], "type": "object" }, "MachineIDPathSegment": { "maxLength": 253, "minLength": 4, "pattern": "^dm-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "type": "string" }, "MachineListItem": { "additionalProperties": false, "properties": { "autosleep_seconds": { "description": "Seconds of inactivity before autosleep. 0 disables autosleep.", "format": "int64", "maximum": 9223372036, "minimum": 0, "type": "integer" }, "created_at": { "format": "date-time", "type": "string" }, "desired_state": { "enum": [ "running", "sleeping", "destroyed" ], "type": "string" }, "machine_id": { "type": "string" }, "memory_mib": { "description": "Memory in MiB.", "format": "int64", "type": "integer" }, "phase": { "enum": [ "accepted", "placement_pending", "starting", "running", "stopping", "sleeping", "destroying", "destroyed", "failed" ], "type": "string" }, "storage_gib": { "format": "int64", "type": "integer" }, "vcpu": { "description": "CPU in vCPUs.", "format": "double", "type": "number" } }, "required": [ "machine_id", "vcpu", "memory_mib", "storage_gib", "autosleep_seconds", "desired_state", "phase", "created_at" ], "type": "object" }, "MachineListResponse": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/MachineListItem" }, "type": [ "array", "null" ] }, "next_cursor": { "type": "string" } }, "required": [ "items" ], "type": "object" }, "PublicPathSegment": { "maxLength": 253, "minLength": 1, "pattern": "^[A-Za-z0-9]([A-Za-z0-9._-]*[A-Za-z0-9])?$", "type": "string" }, "SSHConnection": { "additionalProperties": false, "properties": { "endpoint": { "type": "string" }, "host_trust": { "$ref": "#/components/schemas/SSHHostTrust" }, "port": { "format": "int64", "type": "integer" }, "ssh_username": { "type": "string" }, "user_certificate": { "type": "string" } }, "required": [ "endpoint", "port", "ssh_username" ], "type": "object" }, "SSHHostTrust": { "additionalProperties": false, "properties": { "host_pattern": { "type": "string" }, "kind": { "enum": [ "cert_authority" ], "type": "string" }, "public_key": { "type": "string" } }, "required": [ "kind", "host_pattern", "public_key" ], "type": "object" }, "SSHSessionListResponse": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/SSHSessionResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "type": "string" } }, "required": [ "items" ], "type": "object" }, "SSHSessionResponse": { "additionalProperties": false, "properties": { "connection": { "$ref": "#/components/schemas/SSHConnection" }, "created_at": { "format": "date-time", "type": "string" }, "error_code": { "type": "string" }, "error_message": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "machine_id": { "type": "string" }, "ready_at": { "format": "date-time", "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "session_id": { "type": "string" }, "status": { "enum": [ "wake_in_progress", "ready", "closed", "expired", "failed" ], "type": "string" } }, "required": [ "session_id", "machine_id", "status", "created_at" ], "type": "object" }, "UpdateMachineRequest": { "additionalProperties": false, "properties": { "autosleep": { "description": "Idle window before autosleep. Accepts fixed duration units like 30s, 30m, 2h, 7d3h4s, or 1w3d, raw seconds (\"1800\"), or never to disable.", "type": "string" }, "memory_mib": { "description": "Memory in MiB.", "format": "int64", "type": "integer" }, "storage_gib": { "description": "Storage in GiB.", "format": "int64", "type": "integer" }, "vcpu": { "description": "CPU in vCPUs.", "format": "double", "type": "number" } }, "type": "object" } }, "securitySchemes": { "ApiKeyAuth": { "description": "Dedalus API key. Alternative to Bearer token.", "in": "header", "name": "x-api-key", "type": "apiKey" }, "BearerAuth": { "bearerFormat": "Dedalus API key", "description": "Dedalus API key in Authorization: Bearer \u003ckey\u003e.", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Controlplane API for Dedalus Cloud Services (DCS).", "title": "Dedalus Cloud Services API", "version": "v1" }, "openapi": "3.1.0", "paths": { "/v1/machines": { "get": { "operationId": "listMachines", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "explode": false, "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer" } }, { "explode": false, "in": "query", "name": "cursor", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MachineListResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "List machines", "tags": [ "Machine Lifecycle" ] }, "post": { "operationId": "createMachine", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateMachineRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "Create converged inline", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "Create accepted and pending convergence", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "beta_access_required": { "value": { "error_code": "BETA_ACCESS_REQUIRED", "message": "DCS is in private beta; this org has not been admitted", "retryable": false } }, "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "idempotency_key_reused": { "value": { "error_code": "IDEMPOTENCY_KEY_REUSED", "message": "idempotency key reused with different request parameters", "retryable": false, "details": { "expected_request_hash": "9ad5f2ad", "provided_request_hash": "a2b7e8d4" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Create conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Create machine", "tags": [ "Machine Lifecycle" ] } }, "/v1/machines/{machine_id}": { "delete": { "operationId": "deleteMachine", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "Mutation accepted or in-progress", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "conflict": { "value": { "error_code": "REVISION_MISMATCH", "message": "revision mismatch", "retryable": true, "details": { "expected_revision": "43", "provided_revision": "42" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Revision conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Destroy machine", "tags": [ "Machine Lifecycle" ] }, "get": { "operationId": "getMachine", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MachineDetailResponse" } } }, "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } } } }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Get machine", "tags": [ "Machine Lifecycle" ] }, "patch": { "operationId": "patchMachine", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMachineRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "Mutation accepted or in-progress", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "fence_conflict": { "value": { "error_code": "REVISION_MISMATCH", "message": "revision mismatch", "retryable": true, "details": { "expected_revision": "43", "provided_revision": "42" } } }, "invalid_state": { "value": { "error_code": "INVALID_STATE", "message": "requested lifecycle transition is invalid for current machine state", "retryable": false, "details": { "current_desired_state": "destroyed", "current_observed_state": "destroyed", "expected_observed_state": "running", "target_desired_state": "running" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "sleep_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "sleep_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } }, "sleep_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "sleep_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Update machine", "tags": [ "Machine Lifecycle" ] } }, "/v1/machines/{machine_id}/executions": { "get": { "operationId": "listMachineExecutions", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "explode": false, "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer" } }, { "explode": false, "in": "query", "name": "cursor", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionListResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "List executions", "tags": [ "Machine Lifecycle", "Machine Executions" ] }, "post": { "operationId": "createMachineExecution", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateExecutionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "idempotency_key_reused": { "value": { "error_code": "IDEMPOTENCY_KEY_REUSED", "message": "idempotency key reused with different request parameters", "retryable": false, "details": { "expected_request_hash": "9ad5f2ad", "provided_request_hash": "a2b7e8d4" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Create conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Create execution", "tags": [ "Machine Lifecycle", "Machine Executions" ] } }, "/v1/machines/{machine_id}/executions/{execution_id}": { "delete": { "operationId": "deleteMachineExecution", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "path", "name": "execution_id", "required": true, "schema": { "$ref": "#/components/schemas/PublicPathSegment" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Delete execution", "tags": [ "Machine Lifecycle", "Machine Executions" ] }, "get": { "operationId": "getMachineExecution", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "path", "name": "execution_id", "required": true, "schema": { "$ref": "#/components/schemas/PublicPathSegment" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Get execution", "tags": [ "Machine Lifecycle", "Machine Executions" ] } }, "/v1/machines/{machine_id}/executions/{execution_id}/events": { "get": { "operationId": "listMachineExecutionEvents", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "path", "name": "execution_id", "required": true, "schema": { "$ref": "#/components/schemas/PublicPathSegment" } }, { "explode": false, "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer" } }, { "explode": false, "in": "query", "name": "cursor", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionEventsResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "List execution events", "tags": [ "Machine Lifecycle", "Machine Executions" ] } }, "/v1/machines/{machine_id}/executions/{execution_id}/output": { "get": { "operationId": "getMachineExecutionOutput", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "path", "name": "execution_id", "required": true, "schema": { "$ref": "#/components/schemas/PublicPathSegment" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExecutionOutputResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Get execution output", "tags": [ "Machine Lifecycle", "Machine Executions" ] } }, "/v1/machines/{machine_id}/sleep": { "post": { "operationId": "sleepMachine", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "Mutation accepted or in-progress", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "fence_conflict": { "value": { "error_code": "REVISION_MISMATCH", "message": "revision mismatch", "retryable": true, "details": { "expected_revision": "43", "provided_revision": "42" } } }, "invalid_state": { "value": { "error_code": "INVALID_STATE", "message": "requested lifecycle transition is invalid for current machine state", "retryable": false, "details": { "current_desired_state": "running", "current_observed_state": "error", "expected_observed_state": "running", "target_desired_state": "sleeping" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "sleep_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "sleep_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } }, "sleep_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "sleep_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Sleep a running machine", "tags": [ "Machine Lifecycle" ] } }, "/v1/machines/{machine_id}/ssh": { "get": { "operationId": "listMachineSSHSessions", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "explode": false, "in": "query", "name": "limit", "schema": { "format": "int64", "type": "integer" } }, { "explode": false, "in": "query", "name": "cursor", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSHSessionListResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "List SSH sessions", "tags": [ "Machine Lifecycle", "Machine SSH" ] }, "post": { "operationId": "createMachineSSHSession", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSSHSessionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSHSessionResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "idempotency_key_reused": { "value": { "error_code": "IDEMPOTENCY_KEY_REUSED", "message": "idempotency key reused with different request parameters", "retryable": false, "details": { "expected_request_hash": "9ad5f2ad", "provided_request_hash": "a2b7e8d4" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Create conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Create SSH session", "tags": [ "Machine Lifecycle", "Machine SSH" ] } }, "/v1/machines/{machine_id}/ssh/{session_id}": { "delete": { "operationId": "deleteMachineSSHSession", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "path", "name": "session_id", "required": true, "schema": { "$ref": "#/components/schemas/PublicPathSegment" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSHSessionResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Delete SSH session", "tags": [ "Machine Lifecycle", "Machine SSH" ] }, "get": { "operationId": "getMachineSSHSession", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "path", "name": "session_id", "required": true, "schema": { "$ref": "#/components/schemas/PublicPathSegment" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SSHSessionResponse" } } }, "description": "OK" }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "read_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "read_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Get SSH session", "tags": [ "Machine Lifecycle", "Machine SSH" ] } }, "/v1/machines/{machine_id}/wake": { "post": { "operationId": "wakeMachine", "parameters": [ { "in": "header", "name": "X-Dedalus-Org-Id", "schema": { "type": "string" } }, { "in": "path", "name": "machine_id", "required": true, "schema": { "$ref": "#/components/schemas/MachineIDPathSegment" } }, { "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecycleResponse" } } }, "description": "Mutation accepted or in-progress", "headers": { "ETag": { "schema": { "type": "string" } }, "Location": { "schema": { "type": "string" } }, "X-Dedalus-Storage-Operation-Id": { "schema": { "type": [ "string", "null" ] } } } }, "401": { "content": { "application/json": { "examples": { "invalid_key": { "value": { "error_code": "AUTH_INVALID", "message": "invalid Dedalus API key", "retryable": false } }, "missing_key": { "value": { "error_code": "AUTH_REQUIRED", "message": "missing Dedalus API key", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Authentication required" }, "403": { "content": { "application/json": { "examples": { "org_mismatch": { "value": { "error_code": "AUTH_ORG_MISMATCH", "message": "org scope does not match API key ownership", "retryable": false } }, "scope_forbidden": { "value": { "error_code": "AUTH_SCOPE_FORBIDDEN", "message": "required authorization scope is missing", "retryable": false } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Forbidden" }, "409": { "content": { "application/json": { "examples": { "fence_conflict": { "value": { "error_code": "REVISION_MISMATCH", "message": "revision mismatch", "retryable": true, "details": { "expected_revision": "43", "provided_revision": "42" } } }, "invalid_state": { "value": { "error_code": "INVALID_STATE", "message": "requested lifecycle transition is invalid for current machine state", "retryable": false, "details": { "current_desired_state": "sleeping", "current_observed_state": "error", "expected_observed_state": "sleeping", "target_desired_state": "running" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "examples": { "idempotency_in_flight": { "value": { "error_code": "RATE_LIMITED", "message": "idempotency key is already in-flight", "retryable": true, "retry_after_ms": 250 } }, "mutation_rate_limited": { "value": { "error_code": "RATE_LIMITED", "message": "mutation rate limit exceeded", "retryable": true, "retry_after_ms": 84, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Rate limited" }, "503": { "content": { "application/json": { "examples": { "mutation_limiter_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "mutation rate limit check is unavailable", "retryable": true, "details": { "rate_limit_scope": "mutating_lifecycle_routes" } } }, "runtime_unavailable": { "value": { "error_code": "DEPENDENCY_UNAVAILABLE", "message": "runtime unavailable", "retryable": true } } }, "schema": { "additionalProperties": false, "properties": { "details": { "additionalProperties": { "type": "string" }, "type": "object" }, "error_code": { "type": "string" }, "message": { "type": "string" }, "retry_after_ms": { "format": "int64", "type": "integer" }, "retryable": { "type": "boolean" } }, "required": [ "error_code", "message", "retryable" ], "type": "object" } } }, "description": "Dependency unavailable" }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error" } }, "summary": "Wake a sleeping machine", "tags": [ "Machine Lifecycle" ] } } }, "security": [ { "ApiKeyAuth": [] }, { "BearerAuth": [] } ], "servers": [ { "description": "Official DCS API", "url": "https://dcs.dedaluslabs.ai" } ] }