Skip to main content
PUT
/
tasks
/
{id}
Update a task
curl --request PUT \
  --url https://api.heffl.com/api/v1/tasks/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "title": "<string>",
  "description": "<string>",
  "status": "OPEN",
  "priority": "LOW",
  "dueDate": "2023-11-07T05:31:56Z",
  "startDate": "2023-11-07T05:31:56Z"
}
'
{
  "id": 123,
  "number": "<string>",
  "title": "<string>",
  "status": "<string>",
  "type": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "priority": "<string>",
  "dueDate": "2023-11-07T05:31:56Z",
  "startDate": "2023-11-07T05:31:56Z"
}

Authorizations

x-api-key
string
header
required

API key for authentication. Get yours at app.heffl.com/settings/developers

Path Parameters

id
number
required

Task ID

Body

application/json
title
string

Task title

description
string

Task description

status
enum<string>

Task status

Available options:
OPEN,
IN_PROGRESS,
ON_HOLD,
COMPLETED,
CANCELLED
priority
enum<string>

Task priority

Available options:
LOW,
MEDIUM,
HIGH
dueDate
string<date-time>

Due date

startDate
string<date-time>

Start date

Response

200 - application/json

OK

id
number
required

Task ID

number
string
required

Auto-generated task number

title
string
required

Task title

status
string
required

Task status

type
string
required

Task type

createdAt
string<date-time>
required

When the task was created

description
string | null

Task description

priority
string | null

Task priority

dueDate
string<date-time> | null

Due date

startDate
string<date-time> | null

Start date