> ## Documentation Index
> Fetch the complete documentation index at: https://wordsmithai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Agent

> Read one agent's name, description, creator, owners and link.

> [!NOTE]
>
> **Preview.** This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive `403 mcp_not_enabled`. See the [preview overview](/preview).

Returns one agent. An agent is a legal AI specialist set up for a kind of legal work. The fields match the items [List Agents](/api-reference/agents/list-agents) returns.

Use the `id` to ask the agent a question with [Create Question](/api-reference/agents/create-question), or to filter [List Sessions](/api-reference/sessions/list-sessions).

## Authentication

Requires an API key, or an OAuth token with `agents:read`.

## Path parameters

**agent\_id** `string` *required*

The agent id, from [List Agents](/api-reference/agents/list-agents), or `"default"` for the general Wordsmith agent.

## Response

Returns `200` with the agent.

**id** `string` *required*

The agent id.

**name** `string` *required*

The agent's display name.

**description** `string`

What the agent is set up to do.

**created\_by** `object`

The person who created the agent. `null` for global and repository agents, which record no creator, and when the user no longer exists in your organisation. A creator who has since been removed from the organisation is still returned.

**User Object**

**id** `string`

The user's id, as [List Users](/api-reference/directory/list-users) returns it.

**name** `string`

The user's display name.

**email** `string`

The user's email address.

**owners** `array`

People who hold the Owner role on the agent: they can edit, share and delete it. The creator holds it from the start, and an owner can grant it to others. Lists only active members of your organisation. Empty for global and repository agents.

**User Object**

**id** `string`

The user's id, as [List Users](/api-reference/directory/list-users) returns it.

**name** `string`

The user's display name.

**email** `string`

The user's email address.

**owner\_teams** `array`

Teams that hold the Owner role on the agent. Empty when no team does.

**Team Object**

**id** `string`

The team's id.

**name** `string`

The team's name.

**created\_at** `string`

When the agent was created, as an ISO 8601 UTC timestamp such as `2026-03-22T17:00:00Z`.

**url** `string`

Opens the agent in Wordsmith. `null` for a workspace-only agent, which has no agent page.

```bash cURL theme={null}
curl "https://api.wordsmith.ai/api/v1/agents/3135e518-9205-4887-9ab1-1d56dd38eafb" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"
```

```json Response theme={null}
{
  "id": "3135e518-9205-4887-9ab1-1d56dd38eafb",
  "name": "Commercial Contracts",
  "description": "Reviews and negotiates supply, services and licensing agreements.",
  "created_by": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "owners": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com"
    }
  ],
  "owner_teams": [],
  "created_at": "2026-03-22T17:00:00Z",
  "url": "https://app.wordsmith.ai/chat?agent=8f1c2d4e-6a7b-4c9d-8e0f-1a2b3c4d5e6f"
}
```

## Errors

| Status | `error_code` | When |
| - | - | - |
| 400 | `bad_request` | `agent_id` is neither an id nor `"default"`. |
| 404 | `resource_not_found` | No agent with this id, or the caller cannot read it. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.