Skip to main content
GET
Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.
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 returns, plus url, which opens the agent in Wordsmith. Use the id to ask the agent a question with Create Question, or to filter List Sessions.

​
Authentication

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

​
Path parameters

​
string
required
The agent id, from List Agents, or "default" for the general Wordsmith agent.

​
Response

Returns 200 with the agent.
​
string
required
The agent id.
​
string
required
The agent’s display name.
​
string
What the agent is set up to do.
​
string
Opens the agent in Wordsmith. null for a workspace-only agent, which has no agent page.

​
Errors