> ## 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.

# List Agents

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

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.

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.wordsmith.ai/api/v1/agents' \
  --header 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.wordsmith.ai/api/v1/agents", {
    method: "GET",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  });

  const agents = await response.json();
  console.log(agents);
  ```

  ```python Python theme={null}
  import requests

  url = "https://api.wordsmith.ai/api/v1/agents"
  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
  }

  response = requests.get(url, headers=headers)
  agents = response.json()
  print(agents)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "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"
    }
  ]
  ```
</ResponseExample>

## Response Fields

<ResponseField name="id" type="string">
  The unique identifier for the agent
</ResponseField>

<ResponseField name="name" type="string">
  The display name of the agent
</ResponseField>

<ResponseField name="description" type="string">
  A description of the agent's capabilities and specializations
</ResponseField>

## 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](/api-reference/agents/create-question) endpoint