> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.middesk.com/reference/agent/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.middesk.com/_mcp/server.

# Agent object

> A defined capability that can plan, research, and reason within a workflow.

An agent is a defined set of capabilities that can plan, research, and reason within a workflow. Each agent has a specific `type` that determines its behavior and domain of expertise — for example, a `cip_orchestrator` agent coordinates customer identification program reviews, while domain agents handle narrower tasks like address verification or sanctions screening.

Agents are predefined by Middesk; you don't author your own. To use one, [create a Run](/work-with-agents/run-agents) referencing the agent and its required context. The Run captures the agent's plan and steps, while [Actions](/work-with-agents/take-action) capture moments where the agent pauses for human input.

To list the agents available to your account, see the [Agents API](/api-reference/agents/list-agents). For an introduction to the agent model, see [Work with agents](/work-with-agents).

## Agent object

**`Example JSON response`**

```json title="Example JSON response"
{
  "object": "agent",
  "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
  "type": "cip_orchestrator",
  "name": "CIP Orchestrator",
  "description": "Orchestrates customer identification program reviews across multiple verification domains.",
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z"
}
```

## Agent attributes

| Attribute     | Type               | Description                                                  |
| ------------- | ------------------ | ------------------------------------------------------------ |
| `object`      | string             | Object type identifier. Always `agent`.                      |
| `id`          | string (uuid)      | Unique identifier for the agent.                             |
| `type`        | string             | The agent type identifier (for example, `cip_orchestrator`). |
| `name`        | string             | Human-readable name of the agent.                            |
| `description` | string             | Description of the agent's capabilities.                     |
| `created_at`  | string (date-time) | ISO 8601 timestamp of when the agent was created.            |
| `updated_at`  | string (date-time) | ISO 8601 timestamp of when the agent was last updated.       |

> **Get a demo**
>
> Contact your account manager or [contact sales](https://www.middesk.com/contact-sales) to inquire about access.

> A defined capability that can plan, research, and reason within a workflow.