> ## Documentation Index > Fetch the complete documentation index at: https://docs.dedaluslabs.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create SSH session ## OpenAPI ````yaml /dcs-openapi.json post /v1/machines/{machine_id}/ssh openapi: 3.1.0 info: description: Controlplane API for Dedalus Cloud Services (DCS). title: Dedalus Cloud Services API version: v1 servers: - description: Official DCS API url: https://dcs.dedaluslabs.ai security: - ApiKeyAuth: [] - BearerAuth: [] paths: /v1/machines/{machine_id}/ssh: post: tags: - Machine Lifecycle - Machine SSH summary: Create SSH session 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: internal service authorization is required 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 limiter unavailable retryable: true details: rate_limit_backend: redis 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 components: schemas: MachineIDPathSegment: maxLength: 253 minLength: 4 pattern: ^dm-[a-z0-9]([a-z0-9-]*[a-z0-9])?$ type: string CreateSSHSessionRequest: additionalProperties: false properties: public_key: type: string required: - public_key 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 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 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 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 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 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 .' scheme: bearer type: http ````