Update Task

curl --location --request PATCH 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "status": "completed",
  "priority": "medium"
}'

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

import requests

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

response = requests.patch(url, headers=headers, json=payload)
print(response.json())

{
  "id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
  "display_id": "#12",
  "task_number": 12,
  "title": "Review the Acme NDA",
  "description": "Check the indemnity and termination clauses.",
  "additional_context": "Counterparty has pushed back twice on liability caps.",
  "status": "completed",
  "priority": "medium",
  "team": {
    "id": "1a2b3c4d-5e6f-7081-9200-aabbccddeeff",
    "name": "Legal"
  },
  "creator": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "assigned_to": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "assigned_agent": {
    "id": "66666666-6666-4666-8666-666666666666",
    "counsel_id": "77777777-7777-4777-8777-777777777777",
    "name": "Paralegal"
  },
  "assigned_team": null,
  "matter": null,
  "complete_by": "2026-01-01T00:00:00Z",
  "tags": [
    "nda",
    "urgent"
  ],
  "source_channel": "web",
  "visibility": "customer",
  "archived": false,
  "draft": false,
  "involved_people": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "role": "assignee",
      "access_level": "write"
    }
  ],
  "shared_teams": [],
  "linked_items": [],
  "input_files": [],
  "output_files": [],
  "created_at": "2025-12-31T00:00:00Z",
  "updated_at": "2025-12-31T01:00:00Z"
}

PATCH

api

tasks

{task_id}

curl --location --request PATCH 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "status": "completed",
  "priority": "medium"
}'

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

import requests

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

response = requests.patch(url, headers=headers, json=payload)
print(response.json())

{
  "id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
  "display_id": "#12",
  "task_number": 12,
  "title": "Review the Acme NDA",
  "description": "Check the indemnity and termination clauses.",
  "additional_context": "Counterparty has pushed back twice on liability caps.",
  "status": "completed",
  "priority": "medium",
  "team": {
    "id": "1a2b3c4d-5e6f-7081-9200-aabbccddeeff",
    "name": "Legal"
  },
  "creator": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "assigned_to": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "assigned_agent": {
    "id": "66666666-6666-4666-8666-666666666666",
    "counsel_id": "77777777-7777-4777-8777-777777777777",
    "name": "Paralegal"
  },
  "assigned_team": null,
  "matter": null,
  "complete_by": "2026-01-01T00:00:00Z",
  "tags": [
    "nda",
    "urgent"
  ],
  "source_channel": "web",
  "visibility": "customer",
  "archived": false,
  "draft": false,
  "involved_people": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "role": "assignee",
      "access_level": "write"
    }
  ],
  "shared_teams": [],
  "linked_items": [],
  "input_files": [],
  "output_files": [],
  "created_at": "2025-12-31T00:00:00Z",
  "updated_at": "2025-12-31T01:00:00Z"
}

Only the fields you send are changed, and {} does nothing. An explicit null clears these fields: description, additional_context, assigned_to, assigned_agent, assigned_team_id, complete_by, matter_id. So {"assigned_to": null} unassigns the task. For every other field a null is ignored rather than applied — send a real value (an empty array to empty tags or linked_items). State changes are fields rather than separate endpoints:

To do this	Send
Archive	`{"archived": true}`
Restore from archive	`{"archived": false}`
Accept a draft	`{"draft": false}`
Reassign	`{"assigned_to": "<user id, email or name>"}`
Unassign	`{"assigned_to": null}`

Archiving and drafting are orthogonal to status: an archived task keeps the status it had. People, agents and teams can be referenced by id or by name: a person by user id, email address or name; an agent by its id, name or shortcut; a team by id or name. A reference that matches more than one record is rejected with a 400 that lists the candidates, so pass the id to disambiguate. In the response, assigned_agent.id is the agent’s record id and assigned_agent.counsel_id is the agent id List Agents returns; either is accepted in assigned_agent. counsel_id added 2026-09-05.

Body parameters

string

Short summary of the work.

string

The primary instruction. Send null to clear it.

string

Supplementary context; the description wins on conflict. Send null to clear it.

string

A user id, email address, or name. Send null to unassign.

string

An agent id, the agent’s name, or its shortcut. Send null to detach the agent.

string

A team id or team name. Send null to unassign the team.

string (uuid)

Send null to unfile the task.

enum

not_started, in_progress, waiting_on_external or completed.

enum

no_priority, urgent, high, medium or low.

string

ISO 8601, e.g. “2026-03-22T17:00:00Z”. Send null to clear the due date.

array

Replaces the whole tag list.

array

Replaces the whole link list.

array

Replaces the set of people involved in the task. Each entry is a user id, email address, or name.

boolean

Shelve (true) or restore (false) the task. Orthogonal to status — the task keeps its status.

boolean

Accept a draft with false. Orthogonal to status. To reject a draft, DELETE the task.

curl --location --request PATCH 'https://api.wordsmith.ai/api/v1/tasks/9f8e7d6c-5b4a-3210-9876-543210fedcba' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "status": "completed",
  "priority": "medium"
}'

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

import requests

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

response = requests.patch(url, headers=headers, json=payload)
print(response.json())

{
  "id": "9f8e7d6c-5b4a-3210-9876-543210fedcba",
  "display_id": "#12",
  "task_number": 12,
  "title": "Review the Acme NDA",
  "description": "Check the indemnity and termination clauses.",
  "additional_context": "Counterparty has pushed back twice on liability caps.",
  "status": "completed",
  "priority": "medium",
  "team": {
    "id": "1a2b3c4d-5e6f-7081-9200-aabbccddeeff",
    "name": "Legal"
  },
  "creator": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "assigned_to": {
    "id": "11111111-2222-3333-4444-555555555555",
    "name": "Jane Doe",
    "email": "jane@example.com"
  },
  "assigned_agent": {
    "id": "66666666-6666-4666-8666-666666666666",
    "counsel_id": "77777777-7777-4777-8777-777777777777",
    "name": "Paralegal"
  },
  "assigned_team": null,
  "matter": null,
  "complete_by": "2026-01-01T00:00:00Z",
  "tags": [
    "nda",
    "urgent"
  ],
  "source_channel": "web",
  "visibility": "customer",
  "archived": false,
  "draft": false,
  "involved_people": [
    {
      "id": "11111111-2222-3333-4444-555555555555",
      "name": "Jane Doe",
      "email": "jane@example.com",
      "role": "assignee",
      "access_level": "write"
    }
  ],
  "shared_teams": [],
  "linked_items": [],
  "input_files": [],
  "output_files": [],
  "created_at": "2025-12-31T00:00:00Z",
  "updated_at": "2025-12-31T01:00:00Z"
}

API Documentation

Agents

Assistants (deprecated)

Tasks

Directory

Body parameters

​Body parameters

Body parameters