Retrieve an agent

Retrieves details of a specific agent

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

idstringRequired

Agent ID

agent found

objectstring

Object type identifier.

idstringformat: "uuid"

Unique identifier for the agent

typestring

The agent type identifier

created_atdatetime

Timestamp when the agent was created.

updated_atdatetime

Timestamp when the agent was last updated.

namestring or null

Human-readable name of the agent

descriptionstring or null

Description of the agent's capabilities

1	import requests
2
3	url = "https://api.middesk.com/v1/agents/id"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"object": "agent",
3	"id": "a1b2c3d4-e5f6-4789-a0b1-c2d3e4f50607",
4	"type": "cip_orchestrator",
5	"created_at": "2026-01-15T10:30:00Z",
6	"updated_at": "2026-01-15T10:30:00Z",
7	"name": "CIP Orchestrator",
8	"description": "Orchestrates Customer Identification Program (CIP) verification workflows"
9	}