Dedalus Labs Machine Artifacts API
The Machine Artifacts API from Dedalus Labs — 2 operation(s) for machine artifacts.
OpenAPI Specification
openapi: 3.1.0
info:
title: Dedalus Audio Machine Artifacts API
description: 'MCP gateway for AI agents. Mix-and-match any model with any tool from our marketplace.
## Authentication
Use Bearer token or X-API-Key header authentication:
```
Authorization: Bearer your-api-key-here
```
```
x-api-key: your-api-key-here
```
## Available Endpoints
- **GET /v1/models**: list available models
- **POST /v1/chat/completions**: Chat completions with MCP tools
- **GET /health**: Service health check'
version: 0.0.1
servers:
- url: https://api.dedaluslabs.ai
description: Official Dedalus API
tags:
- name: Machine Artifacts
paths:
/v1/machines/{machine_id}/artifacts:
get:
operationId: listMachineArtifacts
parameters:
- in: header
name: X-Dedalus-Org-Id
schema:
type: string
- in: path
name: machine_id
required: true
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/ArtifactListResponse'
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
'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 limiter unavailable
retryable: true
details:
rate_limit_backend: redis
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 artifacts
tags:
- Machine Artifacts
/v1/machines/{machine_id}/artifacts/{artifact_id}:
delete:
operationId: deleteMachineArtifact
parameters:
- in: header
name: X-Dedalus-Org-Id
schema:
type: string
- in: path
name: machine_id
required: true
schema:
type: string
- in: path
name: artifact_id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ArtifactResponse'
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
'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
summary: Delete artifact
tags:
- Machine Artifacts
get:
operationId: getMachineArtifact
parameters:
- in: header
name: X-Dedalus-Org-Id
schema:
type: string
- in: path
name: machine_id
required: true
schema:
type: string
- in: path
name: artifact_id
required: true
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/ArtifactResponse'
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
'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 limiter unavailable
retryable: true
details:
rate_limit_backend: redis
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 artifact
tags:
- Machine Artifacts
components:
schemas:
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
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
ArtifactResponse:
additionalProperties: false
properties:
artifact_id:
type: string
created_at:
format: date-time
type: string
download_url:
type: string
execution_id:
type: string
expires_at:
format: date-time
type: string
machine_id:
type: string
mime_type:
type: string
name:
type: string
sha256:
type: string
size_bytes:
format: int64
type: integer
required:
- artifact_id
- machine_id
- name
- size_bytes
- created_at
type: object
ArtifactListResponse:
additionalProperties: false
properties:
items:
items:
$ref: '#/components/schemas/ArtifactResponse'
type:
- array
- 'null'
next_cursor:
type: string
required:
- items
type: object
securitySchemes:
Bearer:
type: http
scheme: bearer