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"
  },
  {
    "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
    "name": "Legal Research Agent",
    "description": "Expert in conducting comprehensive legal research and case law analysis"
  },
  {
    "id": "abcdef12-3456-7890-abcd-ef1234567890",
    "name": "Document Drafting Agent",
    "description": "Assists with drafting various legal documents including agreements, letters, and briefs"
  }
]

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"
  },
  {
    "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
    "name": "Legal Research Agent",
    "description": "Expert in conducting comprehensive legal research and case law analysis"
  },
  {
    "id": "abcdef12-3456-7890-abcd-ef1234567890",
    "name": "Document Drafting Agent",
    "description": "Assists with drafting various legal documents including agreements, letters, and briefs"
  }
]

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

Notes

• Only agents that you have read access to will be returned
• 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