Jump toModels

Models

The models your organization may use, and one-off completions.

post/v1/llm/complete

Complete

Needs agent.test

One model call with the builder's instructions and no tools: the quick reply of the agent editor. It is not an agent run (no tools, memory or run history).

Request bodyLlmComplete

messagesCompleteMessage[]Required
at least 1 itemsat most 50 items
2 fields
- contentstringRequired
  at least 1 charactersat most 100000 characters
- rolestringRequired
  One ofuserassistant
modelstringRequired
matches ^[a-z0-9_]{1,40}/[A-Za-z0-9._:/@-]{1,200}$
effortstring or null
One oflowmediumhighxhighmax
fallbacksstring[]
at most 3 items
max_output_tokensinteger or null
at least 1at most 4000
profilestring
One ofstandardprivacyhipaaDefault"standard"
systemstring
Default""at most 200000 characters
temperaturenumber or null
at least 0at most 2

Response200

objectstring
llm_completion
cost_micro_usdinteger
key_ownerstring or null
modelstring or null
providerstring or null
routestring or null
stop_reasonstring or null
textstring
usagemap<string, integer>

Status codes

200Successful Response
422The request is not valid: errors[] names each field.
4XXThe request was refused: the problem says why.
5XXThe API could not answer: the problem says why.

Request

curl -X POST "https://api.mydeepagents.com/v1/llm/complete" \
  -H "Authorization: Bearer $MDA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "content": "content",
        "role": "user"
      }
    ],
    "model": "claude-sonnet-5-5"
  }'

Response · 200

JSON

{
  "object": "llm_completion",
  "cost_micro_usd": 1250000,
  "key_owner": "key owner",
  "model": "claude-sonnet-5-5",
  "provider": "anthropic",
  "route": "route",
  "stop_reason": null,
  "text": "text",
  "usage": {
    "key": 2
  }
}

get/v1/llm/providers

List providers

Needs agent.view

Response200

objectstring
list
dataLlmRoute[]
19 fields
- idstring
- objectstring
  llm_route
- any_modelboolean
- auth_kindsstring[]
- availableboolean
- descriptionstring
- docs_urlstring
- external_idstring or null
- fieldsLlmKeyField[]
  10 fields
  advancedboolean
  auth_kindsstring[]
  helpstring
  kindstring
  One oftexturlselect
  labelstring
  namestring
  optionsstring[]
  placeholderstring
  requiredboolean
  with_secretboolean
- namestring
- own_keyLlmKeySummary or null
  6 fields
  idstring
  healthstring
  One ofhealthyunhealthy
  labelstring
  secret_hintstring or null
  share_with_childrenboolean
  statusstring
  One ofpending_testactivedisabled
- platformboolean
- providerstring
- provider_namestring
- secret_labelstring
- secret_placeholderstring
- secretsLlmRouteSecret[]
  4 fields
  auth_kindstring
  labelstring
  placeholderstring
  requiredboolean
- serves_withstring or null
  One ofownsharedplatform
- shared_fromstring or null
has_moreboolean
next_cursorstring or null
facetsmap<string, map<string, integer>> or null
peoplemap<string, ActorRef> or null
5 fields
- idstring or null
- kindstring
  One ofuserapi_keyservice_accountworkloadend_usersystem
- namestring or null
- avatar_versionstring or null
- emailstring or null
total_countinteger or null
total_count_exactboolean or null

Status codes

200Successful Response
4XXThe request was refused: the problem says why.
5XXThe API could not answer: the problem says why.

Request

curl "https://api.mydeepagents.com/v1/llm/providers" \
  -H "Authorization: Bearer $MDA_API_KEY"

Response · 200

JSON

{
  "object": "list",
  "data": [
    {
      "id": "id",
      "object": "llm_route",
      "any_model": true,
      "auth_kinds": [
        "auth kind"
      ],
      "available": true,
      "description": "Reads new support email and drafts a reply.",
      "docs_url": "https://example.com",
      "external_id": "external id",
      "fields": [
        {
          "advanced": true,
          "auth_kinds": [],
          "help": "help",
          "kind": "text",
          "label": "label",
          "name": "Support triage",
          "options": [],
          "placeholder": "placeholder",
          "required": true,
          "with_secret": true
        }
      ],
      "name": "Support triage",
      "own_key": {
        "id": "id",
        "health": "healthy",
        "label": "label",
        "secret_hint": "secret hint",
        "share_with_children": true,
        "status": "pending_test"
      },
      "platform": true,
      "provider": "anthropic",
      "provider_name": "provider name",
      "secret_label": "secret label",
      "secret_placeholder": "secret placeholder",
      "secrets": [
        {
          "auth_kind": "auth kind",
          "label": "label",
          "placeholder": "placeholder",
          "required": true
        }
      ],
      "serves_with": "own",
      "shared_from": "shared from"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "total_count": 1
}

get/v1/models

List models

Needs agent.view

Query parameters

kindstring
One ofchatembeddingrerankDefault"chat"

Response200

objectstring
list
dataModelOut[]
17 fields
- objectstring
  model
- allowedboolean
- availableboolean
- available_routesstring[]
- capabilitiesobject
  Any JSON object.
- descriptionstring
- display_namestring
- familystring
- kindstring
- model_idstring
- pricesmap<string, map<string, integer>>
- providerstring
- provider_namestring
- retires_atstring or null
- routesstring[]
- statusstring
- successorstring or null
has_moreboolean
next_cursorstring or null
facetsmap<string, map<string, integer>> or null
peoplemap<string, ActorRef> or null
5 fields
- idstring or null
- kindstring
  One ofuserapi_keyservice_accountworkloadend_usersystem
- namestring or null
- avatar_versionstring or null
- emailstring or null
total_countinteger or null
total_count_exactboolean or null

Status codes

200Successful Response
422The request is not valid: errors[] names each field.
4XXThe request was refused: the problem says why.
5XXThe API could not answer: the problem says why.

Request

curl "https://api.mydeepagents.com/v1/models" \
  -H "Authorization: Bearer $MDA_API_KEY"

Response · 200

JSON

{
  "object": "list",
  "data": [
    {
      "object": "model",
      "allowed": true,
      "available": true,
      "available_routes": [
        "available route"
      ],
      "capabilities": {},
      "description": "Reads new support email and drafts a reply.",
      "display_name": "Ada Lovelace",
      "family": "family",
      "kind": "kind",
      "model_id": "claude-sonnet-5-5",
      "prices": {
        "key": {
          "key": 2
        }
      },
      "provider": "anthropic",
      "provider_name": "provider name",
      "retires_at": "2026-11-10T09:30:00.000Z",
      "routes": [
        "route"
      ],
      "status": "status",
      "successor": "successor"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "total_count": 1
}

Build with us

Ready for your first call?

Early access is open. Tell us what you want your agents to do, and we will help you get your first key.

Talk to us Read the API guide