Agents
Get agent
Returns the complete configuration for a single agent identified by agent_id, including persona, voice/language settings, behavioral toggles, dynamic variables, webhook callbacks, and the fully expanded lists of linked tools, system_tools, and analysis_groups. Use this to inspect an agent before updating it or to confirm how it is wired to tools and analysis groups.
curl --request GET \
--url 'https://api.nabrah.ai/api/ext/agent/<agent_id>' \
--header 'X-API-Key: <your-api-key>'{
"agent_id": "00000000-0000-4000-8000-000000000000",
"project_id": "00000000-0000-4000-8000-000000000000",
"created_by_email": "string",
"created_at": "2026-01-15T12:00:00.000Z",
"last_update": "2026-01-15T12:00:00.000Z",
"name": "string",
"start_first": false,
"first_sentence": "string",
"agent_type": "basic",
"who_are_you": "string",
"goal": "string",
"steps": "string",
"allow_interruptions": false,
"voice": "dania",
"support_data": "string",
"languages": [
"ar"
],
"stack": "latest",
"speech_speed": 0.7,
"variables": [
{
"name": "string",
"type": "string",
"default_value": "string"
}
],
"pre_call_callback": {
"url": "string",
"parameters": [
{
"name": "string",
"location": "header",
"data_type": "string",
"value": "string"
}
]
},
"post_call_callback": {
"url": "string",
"parameters": [
{
"name": "string",
"location": "header",
"data_type": "string",
"value": "string"
}
]
},
"post_analysis_callback": {
"url": "string",
"parameters": [
{
"name": "string",
"location": "header",
"data_type": "string",
"value": "string"
}
]
},
"tools": [
{
"id": "00000000-0000-4000-8000-000000000000",
"name": "string"
}
],
"system_tools": [
{
"id": "00000000-0000-4000-8000-000000000000",
"name": "string",
"config": {},
"created_at": "2026-01-15T12:00:00.000Z",
"updated_at": "2026-01-15T12:00:00.000Z",
"when_to_use": "string"
}
],
"analysis_groups": [
{
"id": "00000000-0000-4000-8000-000000000000",
"name": "string"
}
],
"background_ambient": false,
"background_ambient_volume": 0,
"thinking_sound": false,
"thinking_sound_volume": 0,
"language_mode": "single"
}Where agent_id comes from
List agents with GET /api/ext/agent and copy the agent_id, or use the ID returned by POST /api/ext/agent.
Response shape
Returns a full AgentResponse object.
tools and analysis_groups are returned as { id, name } summaries; system_tools include additional config and when_to_use metadata. project_id reflects the workspace the API key is scoped to.
agent_idproject_idnamevoicelanguagestoolssystem_toolsanalysis_groupsAuthorization
X-API-KeystringheaderrequiredYour workspace API key. Create one in the dashboard under API keys.
Path parameters
agent_idstringrequiredUUID of the agent to retrieve.
Get this from GET /api/ext/agent or from the create-agent response (POST /api/ext/agent).
Response
Successful Response
application/json
Validation Error
application/json