List Assistants

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

GET /api/v1/assistants

cURL

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

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

const assistants = await response.json();
console.log(assistants);

import requests

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

response = requests.get(url, headers=headers)
assistants = response.json()
print(assistants)

Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Contract Review Assistant",
    "description": "Specialized in reviewing and analyzing legal contracts for compliance and risk assessment"
  },
  {
    "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
    "name": "Legal Research Assistant",
    "description": "Expert in conducting comprehensive legal research and case law analysis"
  },
  {
    "id": "abcdef12-3456-7890-abcd-ef1234567890",
    "name": "Document Drafting Assistant",
    "description": "Assists with drafting various legal documents including agreements, letters, and briefs"
  }
]

Get a list of all assistants available to your account. Assistants are specialized legal AI agents that can help with specific types of legal work.

cURL

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

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

const assistants = await response.json();
console.log(assistants);

import requests

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

response = requests.get(url, headers=headers)
assistants = response.json()
print(assistants)

Response

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Contract Review Assistant",
    "description": "Specialized in reviewing and analyzing legal contracts for compliance and risk assessment"
  },
  {
    "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
    "name": "Legal Research Assistant",
    "description": "Expert in conducting comprehensive legal research and case law analysis"
  },
  {
    "id": "abcdef12-3456-7890-abcd-ef1234567890",
    "name": "Document Drafting Assistant",
    "description": "Assists with drafting various legal documents including agreements, letters, and briefs"
  }
]

Response Fields

id · string

The unique identifier for the assistant

name · string

The display name of the assistant

description · string

A description of the assistant’s capabilities and specializations

Notes

• Only assistants that you have read access to will be returned
• The list includes both your organization’s custom assistants and any global assistants you have access to
• Use the id field when creating questions with specific assistants via the Create Question endpoint