Reply to Requester

curl --location --request POST 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "content": "We've reviewed the NDA \u2014 see the attached mark-up."
}'

const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "content": "We've reviewed the NDA \u2014 see the attached mark-up."
  }),
});
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",
}
payload = {
    "content": "We've reviewed the NDA \u2014 see the attached mark-up."
}

response = requests.post(url, headers=headers, json=payload)
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"
}

POST

api

tasks

{task_id}

thread

curl --location --request POST 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "content": "We've reviewed the NDA \u2014 see the attached mark-up."
}'

const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "content": "We've reviewed the NDA \u2014 see the attached mark-up."
  }),
});
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",
}
payload = {
    "content": "We've reviewed the NDA \u2014 see the attached mark-up."
}

response = requests.post(url, headers=headers, json=payload)
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"
}

This reaches the requester over the task’s origin channel. For a connected personal mailbox the reply is staged as a draft for the mailbox owner to review and send, rather than sent immediately. The delivery_status on the returned message says which happened — sent or draft — so do not report a reply as delivered without reading it. For an internal note that the requester never sees, add a comment instead.

The requester thread is behind its own feature flag, separate from tasks. This endpoint returns 404 unless it is enabled for your organization.

A task that did not arrive over Slack, email or Teams has no requester to reply to. This endpoint returns 400 for such a task, and any job_id in attachments stays usable.

Partly delivered replies

A reply can reach the requester even though Wordsmith could not confirm that everything completed, for example an attachment that could not be delivered. The response is then a 400 with error_code task_thread_reply_partially_delivered:

{
  "error_code": "task_thread_reply_partially_delivered",
  "ws_api_error_code": "task_thread_reply_partially_delivered",
  "message": "Your reply was sent, but we couldn’t confirm everything completed. Check the requester thread before sending a follow-up."
}

Do not retry this request. The requester already has the reply, and sending it again delivers it twice. The thread may not show the reply, because recording it is one of the steps that can fail. Check the conversation in the origin channel (Slack, Teams or email) before you send a follow-up. Any other 400 means nothing was sent, so you can fix the request and retry.

Body parameters

string

required

The reply body, sent to the requester.

array

Ids of files already in Wordsmith to attach. A job_id does not go here; use attachments.

array

Up to 10 new files to attach, each with exactly one of upload_job_id (the job_id from the file upload endpoint, once the file is uploaded) or url (a public http(s) URL). See Attach Files for the limits.

curl --location --request POST 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "content": "We've reviewed the NDA \u2014 see the attached mark-up."
}'

const response = await fetch("https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba/thread", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "content": "We've reviewed the NDA \u2014 see the attached mark-up."
  }),
});
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",
}
payload = {
    "content": "We've reviewed the NDA \u2014 see the attached mark-up."
}

response = requests.post(url, headers=headers, json=payload)
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"
}

API Documentation

Agents

Assistants (deprecated)

Tasks

Directory

Partly delivered replies

Body parameters

​Partly delivered replies

​Body parameters

Partly delivered replies

Body parameters