agenttools
Tasks

Update a task

No auth required
PATCH/api/tasks/{id}

Parameters

Path
idstringrequired
The task ID (`tsk_…`).

Request body

namestring
descriptionstring | null
priority"low" | "medium" | "high" | "critical"
due_atinteger | null
labelsstring[] | null

Responses

200The updated task.
idstring
Unique identifier for the task, prefixed with `tsk_`.Example: "tsk_xxxxxxxxxxxxxxxxxxxxxxxx"
object"task"
organization_idstring | null
Owning organization ID, or null if the resource is public (created without an API key).
namestring
descriptionstring | null
priority"low" | "medium" | "high" | "critical"
Task priority. Defaults to `low`.
due_atinteger | null
When the task is due. Unix timestamp in seconds.
labelsstring[]
Labels attached to the task. Use ?label= on the list endpoint to filter. Defaults to [].
created_atinteger | null
When the task was created. Unix timestamp in seconds.
updated_atinteger | null
When the task was last updated. Unix timestamp in seconds.
400The request was malformed or failed validation.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
401No valid API key was provided.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
403The caller is authenticated but lacks access to the resource.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.
404The resource does not exist or is not visible to the caller.
errorobject
type"invalid_request_error" | "authentication_error" | "authorization_error" | "not_found_error" | "rate_limit_error" | "api_error"
codestring
Machine-readable error code.
messagestring
Human-readable error message.
paramstring | null
The offending parameter, when applicable.

Example request

curl
curl -X PATCH https://agtls.dev/api/tasks/{id} \
  -H "Content-Type: application/json" \
  -d '{ … }'