Skip to main content
PATCH
/
v1
/
tasks
/
{id}
Update a task
curl --request PATCH \
  --url https://api.slant.app/v1/tasks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Updated task title",
  "description": "<string>",
  "deadline_at": "2023-11-07T05:31:56Z",
  "all_day": true,
  "status": "todo",
  "priority": "low_priority",
  "household_id": "<string>",
  "contact_id": "<string>",
  "business_id": "<string>",
  "assigned_to_id": "<string>",
  "assigned_team_id": "<string>"
}
'
{
  "id": "abc123xyz",
  "title": "Follow up with client",
  "all_day": true,
  "status": "todo",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "deadline_at": "2023-11-07T05:31:56Z",
  "priority": "low_priority",
  "completed_at": "2023-11-07T05:31:56Z",
  "assigned_to": {
    "id": "<string>",
    "name": "<string>",
    "email": "jsmith@example.com"
  },
  "assigned_team": {
    "id": "<string>",
    "name": "<string>"
  },
  "record": {
    "id": "<string>",
    "type": "household",
    "name": "<string>"
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.0 Bearer Token from Clerk authentication

Headers

Idempotency-Key
string

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the original response will be returned.

Path Parameters

id
string
required

The task ID

Body

application/json
title
string

Task title

Example:

"Updated task title"

description
string

Task description

deadline_at
string<date-time>

Deadline for the task

all_day
boolean

Whether this is an all-day task

status
enum<string>

Task status

Available options:
todo,
done
priority
enum<string>

Task priority

Available options:
low_priority,
medium_priority,
high_priority,
urgent_priority
household_id
string

Associate task with a household

contact_id
string

Associate task with a contact

business_id
string

Associate task with a business

assigned_to_id
string

User ID to assign the task to

assigned_team_id
string

Team ID to assign the task to (mutually exclusive with assigned_to_id)

Response

task updated

id
string
required

The task ID

Example:

"abc123xyz"

title
string
required

Task title

Example:

"Follow up with client"

all_day
boolean
required

Whether this is an all-day task

status
enum<string>
required

Task status

Available options:
todo,
done
created_at
string<date-time>
required

When the task was created

updated_at
string<date-time>
required

When the task was last updated

description
string | null

Task description

deadline_at
string<date-time> | null

Deadline for the task

priority
enum<string> | null

Task priority

Available options:
low_priority,
medium_priority,
high_priority,
urgent_priority
completed_at
string<date-time> | null

When the task was completed

assigned_to
object
assigned_team
object
record
object

The associated record (household, contact, or business) this task is linked to