Skip to main content
PUT
Update a task

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

publicAPI.v2.all

Public API v2

Path Parameters

id
integer
required

The task ID.

Body

application/json
name
string

Updated task name.

Example:

"Follow up call"

dueAt
string<date-time>

Updated due date.

Example:

"2026-07-01T15:00:00Z"

description
string

Updated task description.

Example:

"Discuss renewal options."

priority
integer

Updated task priority.

Example:

1

status
enum<string>

Updated task status. Any other value returns 400. Setting COMPLETED also sets completedAt.

Available options:
TODO,
QUEUED,
SCHEDULED,
STARTED,
RETRYING,
PAUSED,
PENDING,
COMPLETED,
PASTDUE,
ERROR,
CANCELED,
SKIPPED,
DUE_TODAY,
DELETED

Response

The updated task.

success
boolean
Example:

true

data
object