List Agents

Get all agents (legal AI specialists) that you have read access to

GET /api/v1/agents

cURL

curl --location --request GET 'https://api.wordsmith.ai/api/v1/agents' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Contract Review Agent",
    "description": "Specialized in reviewing and analyzing legal contracts for compliance and risk assessment",
    "created_by": {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "[e-mail]"
    },
    "owners": [
      {
        "id": "11111111-2222-3333-4444-555555555555",
        "name": "Jane Doe",
        "email": "[e-mail]"
      },
      {
        "id": "66666666-7777-8888-9999-000000000000",
        "name": "Sam Lee",
        "email": "[e-mail]"
      }
    ],
    "owner_teams": [
      {
        "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "name": "Commercial"
      }
    ],
    "created_at": "2026-03-22T17:00:00Z",
    "url": "https://app.wordsmith.ai/chat?agent=8f1c2d4e-6a7b-4c9d-8e0f-1a2b3c4d5e6f"
  },
  {
    "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
    "name": "Legal Research Agent",
    "description": "Expert in conducting comprehensive legal research and case law analysis",
    "created_by": null,
    "owners": [],
    "owner_teams": [],
    "created_at": "2025-11-04T09:30:00Z",
    "url": null
  }
]

Get a list of all agents available to your account. Each agent is a legal AI specialist set up for a particular kind of legal work.

cURL

curl --location --request GET 'https://api.wordsmith.ai/api/v1/agents' \
--header 'Authorization: Bearer YOUR_API_KEY'

Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Contract Review Agent",
    "description": "Specialized in reviewing and analyzing legal contracts for compliance and risk assessment",
    "created_by": {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "[e-mail]"
    },
    "owners": [
      {
        "id": "11111111-2222-3333-4444-555555555555",
        "name": "Jane Doe",
        "email": "[e-mail]"
      },
      {
        "id": "66666666-7777-8888-9999-000000000000",
        "name": "Sam Lee",
        "email": "[e-mail]"
      }
    ],
    "owner_teams": [
      {
        "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "name": "Commercial"
      }
    ],
    "created_at": "2026-03-22T17:00:00Z",
    "url": "https://app.wordsmith.ai/chat?agent=8f1c2d4e-6a7b-4c9d-8e0f-1a2b3c4d5e6f"
  },
  {
    "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
    "name": "Legal Research Agent",
    "description": "Expert in conducting comprehensive legal research and case law analysis",
    "created_by": null,
    "owners": [],
    "owner_teams": [],
    "created_at": "2025-11-04T09:30:00Z",
    "url": null
  }
]

Response Fields

id · string

The unique identifier for the agent

name · string

The display name of the agent

description · string

A description of the agent’s capabilities and specializations

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.

Show User Object

id · string

The user’s id, as 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.

Show User Object

id · string

The user’s id, as 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.

Show 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 | null

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

Notes

• Only agents that you have read access to will be returned
• created_by, owners and owner_teams name the same people and teams as the agent’s sharing settings in Wordsmith, and never anyone outside your organisation
• The list includes both your organization’s custom agents and any global agents you have access to
• Use the id field when creating questions with specific agents via the Create Question endpoint