List Thread Messages

curl --location --request GET 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread' \
--header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread", {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

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

[
  {
    "id": "bbbb1111-cccc-2222-dddd-444444444444",
    "task_id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
    "direction": "outbound",
    "content": "We've reviewed the NDA \u2014 see the attached mark-up.",
    "file_ids": [],
    "sender": {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "sender_agent": null,
    "sender_display_name": "Jane Doe",
    "delivery_status": "sent",
    "created_at": "2025-12-31T01:01:40Z"
  },
  {
    "id": "cccc2222-dddd-3333-eeee-555555555555",
    "task_id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
    "direction": "outbound",
    "content": "The revised termination clause is attached.",
    "file_ids": [],
    "sender": null,
    "sender_agent": {
      "id": "66666666-6666-4666-8666-666666666666",
      "counsel_id": "77777777-7777-4777-8777-777777777777",
      "name": "Paralegal"
    },
    "sender_display_name": "Paralegal",
    "delivery_status": "draft",
    "created_at": "2025-12-31T02:15:00Z"
  }
]

GET

api

tasks

{task_id}

thread

curl --location --request GET 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread' \
--header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread", {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

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

[
  {
    "id": "bbbb1111-cccc-2222-dddd-444444444444",
    "task_id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
    "direction": "outbound",
    "content": "We've reviewed the NDA \u2014 see the attached mark-up.",
    "file_ids": [],
    "sender": {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "sender_agent": null,
    "sender_display_name": "Jane Doe",
    "delivery_status": "sent",
    "created_at": "2025-12-31T01:01:40Z"
  },
  {
    "id": "cccc2222-dddd-3333-eeee-555555555555",
    "task_id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
    "direction": "outbound",
    "content": "The revised termination clause is attached.",
    "file_ids": [],
    "sender": null,
    "sender_agent": {
      "id": "66666666-6666-4666-8666-666666666666",
      "counsel_id": "77777777-7777-4777-8777-777777777777",
      "name": "Paralegal"
    },
    "sender_display_name": "Paralegal",
    "delivery_status": "draft",
    "created_at": "2025-12-31T02:15:00Z"
  }
]

Tasks raised over Slack, email or a mailbox carry a thread with the requester. direction is inbound for messages from the requester and outbound for replies back to them. A reply written by an agent sets sender_agent: its id is the agent’s record id and its counsel_id is the agent id List Agents returns. counsel_id added 2026-09-05. direction does not tell you whether an outbound reply reached the requester — read delivery_status for that. It is sent once the channel confirmed delivery, and draft while the reply is only staged in a connected mailbox for its owner to review and send. failed and canceled are reserved for a reply that was attempted and did not arrive. Treat anything other than sent as not delivered, including a value your integration does not recognise. Inbound messages are always sent.

The requester thread is behind its own feature flag, separate from tasks. These two endpoints return 404 unless it is enabled for your organization.

curl --location --request GET 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread' \
--header 'Authorization: Bearer YOUR_API_KEY'

const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread", {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
});
const data = await response.json();
console.log(data);

import requests

url = "https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

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

[
  {
    "id": "bbbb1111-cccc-2222-dddd-444444444444",
    "task_id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
    "direction": "outbound",
    "content": "We've reviewed the NDA \u2014 see the attached mark-up.",
    "file_ids": [],
    "sender": {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "sender_agent": null,
    "sender_display_name": "Jane Doe",
    "delivery_status": "sent",
    "created_at": "2025-12-31T01:01:40Z"
  },
  {
    "id": "cccc2222-dddd-3333-eeee-555555555555",
    "task_id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
    "direction": "outbound",
    "content": "The revised termination clause is attached.",
    "file_ids": [],
    "sender": null,
    "sender_agent": {
      "id": "66666666-6666-4666-8666-666666666666",
      "counsel_id": "77777777-7777-4777-8777-777777777777",
      "name": "Paralegal"
    },
    "sender_display_name": "Paralegal",
    "delivery_status": "draft",
    "created_at": "2025-12-31T02:15:00Z"
  }
]

API Documentation

Agents

Assistants (deprecated)

Tasks

Directory