gtm-internal
gtm-internal

Update Task

Patch a task by id. Only fields present in the body are applied (an explicit null clears). status/disposition are dual-written via apply_task_disposition (work-layer expand/contract), so a sweep survives the status backfill. Soft-delete = set killed_at (or disposition ="archived"); restore = killed_at: null. Mirrors the MCP update_task — any internal user may edit any task (staff ops table). A changed content field adopts a live suggestion unless the patch explicitly sets its status, disposition, or killed_at. Authentication is internal JWT only; MCP API-key/OAuth edits do not count as human acceptance.

patch/gtm-internal/tasks/{task_id}

Request

  • Base URL
    https://api-v1.unusual.ai (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Password
    Token URL: /auth/login

Path parameters

task_idstring required

Request body

categorystring nullable
titlestring nullable
detailstring nullable
attachmentsunknown
labelsunknown
prioritystring nullable
assigneestring nullable
subscribersunknown
statusstring nullable
dispositionstring nullable
audiencestring nullable
visibility_statusstring nullable
external_refstring nullable
external_urlstring nullable
due_atstring nullable
completed_atstring nullable
killed_atstring nullable
positioninteger nullable
parent_task_idstring nullable
priority_idstring nullable
contact_idstring nullable

Response

Successful Response

idstring required
account_idstring nullable
domain_idstring nullable
org_idstring nullable
priority_idstring nullable
parent_task_idstring nullable
contact_idstring nullable
categorystring nullable
titlestring required
detailstring nullable
attachmentsunknown
labelsunknown
prioritystring nullable
created_bystring nullable
assigneestring nullable
subscribersunknown
statusstring nullable
dispositionstring nullable
sourcestring nullable
audiencestring nullable
visibility_statusstring nullable
external_refstring nullable
external_urlstring nullable
due_atstring nullable
completed_atstring nullable
killed_atstring nullable
positioninteger nullable
created_atstring nullable
updated_atstring nullable
domain_hoststring nullable
org_namestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.