Skip to main content
PATCH
Change a task

Authorizations

Authorization
string
header
required

An API key from Settings, API keys. It starts with rc_live_.

Path Parameters

id
string
required

The task's record ID.

Body

application/json

Send at least one field. An empty string clears notes, due_on or assignee_person_id, as null does. entity_type and entity_id are refused.

title
string

Cannot be empty.

notes
string | null
status
enum<string>

done completes the task; open reopens it.

Available options:
open,
done
priority
enum<string>
Available options:
low,
normal,
high
due_on
string | null

The day it is due, YYYY-MM-DD.

assignee_person_id
string | null

The record ID of a person in your organization.

Response

The task, as it now is.

task
object
required

A task. The list returns exactly these fields; creating and changing a task return it as stored, which can carry more.