Skip to content

REST API reference

Dexto REST endpoints, request shapes, and curl examples.

Setting	Value
Base URL	`https://app.dexto.ai`
Authorization	`Authorization: Bearer $DEXTO_API_KEY`
Content type	`application/json`

Endpoints

Service	Method	Path	Request	Response
Models	`GET`	`/v1/models`	—	`ModelList`
Models	`POST`	`/v1/chat/completions`	`ChatCompletionRequest`	`ChatCompletion` or SSE stream
Computers	`GET`	`/api/desktops/{desktopId}/computer`	path parameter	`ComputerEnvelope`
Computers	`POST`	`/api/desktops/{desktopId}/computer/process/exec`	`ProcessExecRequest`	`ProcessExecResult`
Computers	`POST`	`/api/desktops/{desktopId}/computer/fs/read`	`FileReadRequest`	`FileReadResult`
Computers	`POST`	`/api/desktops/{desktopId}/computer/fs/write`	`FileWriteRequest`	`FileWriteResult`
Media	`GET`	`/api/media/presets`	—	`MediaPresetList`
Media	`POST`	`/api/media/estimates`	`MediaEstimateRequest`	`MediaEstimate`
Media	`POST`	`/api/media/generations`	`MediaGenerationRequest`	`MediaGeneration`
Media	`GET`	`/api/media/generations/{operationId}`	path parameter	`MediaGenerationEnvelope`
Sites	`GET`	`/api/sites`	—	`SiteList`
Sites	`POST`	`/api/sites/deployments`	`SiteDeploymentPackage`	`SiteDeploymentResult`
Sites	`GET`	`/api/sites/{siteId}/deployments`	path parameter	`SiteDeploymentList`
Sites	`GET`	`/api/sites/{siteId}/data`	path parameter	`SiteCollectionList`
Artifacts	`POST`	`/api/artifacts`	binary body + `name` query	`RuntimeArtifactEnvelope`
Artifacts	`GET`	`/api/artifacts`	—	`RuntimeArtifactList`
Artifacts	`GET`	`/api/artifacts/{artifactId}/content`	path parameter	Binary content
Artifacts	`POST`	`/api/artifacts/{artifactId}/public-url`	`ArtifactExportRequest`	`ArtifactExportResult`
Agents	`GET`	`/api/agents`	`AgentListQuery`	`AgentList`
Agents	`GET`	`/api/agents/{agentId}`	path parameter	`AgentEnvelope`
Capabilities	`GET`	`/api/capabilities/sources`	`PaginationQuery`	`CapabilitySourceList`
Capabilities	`GET`	`/api/capabilities/search`	`CapabilitySearchQuery`	`CapabilitySearchResult`
Capabilities	`POST`	`/api/capabilities/describe`	`CapabilityDescribeRequest`	`CapabilityDescribeResult`
Capabilities	`POST`	`/api/capabilities/call`	`CapabilityCallRequest`	`CapabilityCallResult`
Marketplace	`GET`	`/api/marketplace`	`MarketplaceListQuery`	`MarketplaceList`
Marketplace	`GET`	`/api/marketplace/{kind}/{listingId}`	path parameters	`MarketplaceListing`

Errors

Status	Meaning
`400`	Invalid query or JSON body
`401`	Missing or invalid API key
`403`	API key cannot access the operation
`404`	Resource not found or not visible to the key owner
`429`	Rate or usage limit exceeded
`409`	Resource state conflict or expired media estimate
`500`	Internal execution failure

{
    "error": {
        "code": "validation_failed",
        "message": "Request validation failed.",
        "details": {
            "fields": { "q": "Required" }
        }
    }
}

Detailed schemas