Skip to main content
GET /api/v1/cloud/agents/{agent_id} Returns the full details of the specified Agent.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

​
Path parameters

ParameterTypeRequiredDescription
agent_idstringYesAgent unique identifier with the agent_ prefix

​
Query parameters

ParameterTypeRequiredDescription
versionintegerNoReturn a specific Agent version snapshot. Omit to return the current Agent

​
Example request

curl -X GET "https://api.qoder.com/api/v1/cloud/agents/agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Authorization: Bearer $QODER_PAT"

​
Example response

HTTP 200 OK 
{
  "type": "agent",
  "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "name": "doc-test-agent",
  "description": "",
  "model": "ultimate",
  "system": "You are a documentation testing assistant.",
  "tools": [],
  "mcp_servers": [],
  "skills": [
    {"type": "custom", "skill_id": "skill_019e5d133c057536872f745e0b6dbd5d"}
  ],
  "metadata": {},
  "multiagent": null,
  "version": 1,
  "archived_at": null,
  "created_at": "2026-05-18T15:26:39.61669Z",
  "updated_at": "2026-05-18T15:26:39.61669Z"
}

​
Response fields

When version is omitted, the response is the current Agent object. When version is provided, the response is an Agent version snapshot.
FieldTypeDescription
typestringAlways "agent"
idstringAgent unique identifier
namestringAgent name
descriptionstringAgent description
modelstring | objectModel identifier. See Agent model
systemstringSystem prompt
toolsarray of Agent toolTool configuration list
mcp_serversarray of MCP serverMCP server configuration
skillsarray of Skill bindingSkill bindings
metadataMetadata objectCustom metadata
multiagentMultiagent | nullAgents configuration, null when not set
versionintegerCurrent version
archived_atstring|nullArchive time (ISO 8601), null when not archived
created_atstringCreation time (ISO 8601)
updated_atstringLast update time (ISO 8601)

​
Errors

HTTPTypeTrigger
400invalid_request_errorversion is not a positive integer
401authentication_errorPAT invalid or expired
403permission_errorNot authorized for this Agent
404not_found_errorAgent with the given ID does not exist
See Errors for the full error envelope.

​
Error response example

{
  "type": "error",
  "request_id": "cb80235f-76a2-4ff3-9e28-5aa2da12dc14",
  "error": {
    "type": "not_found_error",
    "message": "Agent 'agent_nonexistent' was not found."
  }
}

Agent setup

Create a reusable, versioned agent configuration.