Agents
Get agent
Retrieve agent details by its unique key.
Gateway not-found behavior: Unknown agentKey, lookup after soft-delete, and other AI-backend failures that return 404 from the Python query service are surfaced by the Node gateway as HTTP 404 with an ErrorResponse body.
get/agents/{agentKey}
Path parameters
agentKeystring required
Unique agent identifier
Response
Agent details
Example response
{
"status": "success",
"message": "Agent retrieved successfully",
"agent": {
"_id": "agentInstances/e6f848ca-e2ab-4594-9925-e1136629f474",
"_key": "e6f848ca-e2ab-4594-9925-e1136629f474",
"_rev": "_lkNlcOm---",
"name": "Customer Support Assistant",
"models": [
{
"modelType": "llm",
"provider": "azureOpenAI",
"modelName": "gpt-5.4-mini",
"modelKey": "f3a4b5b6-5b6c-4e85-9097-3202cfe696fc",
"isMultimodal": true,
"isReasoning": true,
"isDefault": true,
"modelFriendlyName": "GPT 5.4 mini"
}
],
"webSearch": {
"provider": "serper"
},
"access_type": "INDIVIDUAL",
"user_role": "OWNER"
}
}