Get Agent

Read one agent’s name, description and link.

GET /api/v1/agents/{agent_id}

cURL

curl "https://api.wordsmith.ai/api/v1/agents/3135e518-9205-4887-9ab1-1d56dd38eafb" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "3135e518-9205-4887-9ab1-1d56dd38eafb",
  "name": "Commercial Contracts",
  "description": "Reviews and negotiates supply, services and licensing agreements.",
  "url": "https://app.wordsmith.ai/chat?agent=8f1c2d4e-6a7b-4c9d-8e0f-1a2b3c4d5e6f"
}

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

agent_id · string · required

The agent id, from 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.

url · string

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

cURL

curl "https://api.wordsmith.ai/api/v1/agents/3135e518-9205-4887-9ab1-1d56dd38eafb" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

Response

{
  "id": "3135e518-9205-4887-9ab1-1d56dd38eafb",
  "name": "Commercial Contracts",
  "description": "Reviews and negotiates supply, services and licensing agreements.",
  "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.