Skip to main content
POST
Create or change a task

Authorizations

Authorization
string
header
required

Supabase JWT — Authorization: Bearer <token>.

Body

application/json
merchant_id
string<uuid>

Optional company to act on. Admins and sub-merchant operators only; other callers always use their token's company.

task_id
string<uuid>

The task to change (merchant_task.id, from list_tasks). Leave out to create a task.

title
string

Title, 1 to 200 characters. Required to create.

Required string length: 1 - 200
assignee_profile_id
string<uuid>

Who does it (profile.id of an active user of the company who can see the candidate or position). Required to create.

due_at
string | null

Due date and time (ISO 8601 with offset). An empty string (or null) removes it; left out keeps it.

Pattern: ^$|^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2})$
notes
string | null

Notes, at most 4000 characters. An empty string (or null) removes them; left out keeps them.

Maximum string length: 4000
candidate_id
string<uuid>

Create only: the candidate the task is about (profile_interview.id).

application_id
string<uuid>

Create only: one application of the candidate (position_result.id); the candidate is taken from it.

position_id
string<uuid>

Create only: the position (position_def_set.id) or interview (interview_def_set.id) the task is about.

status
enum<string>

open, done or cancelled. Cancelled is final: a cancelled task cannot be changed or reopened. Applied after the other changes.

Available options:
open,
done,
cancelled

Response

The task after the call.

task_id
string<uuid>
required

The task (merchant_task.id).

created
boolean
required

true when this call created the task.

status
enum<string>
required

The task status after the call.

Available options:
open,
done,
cancelled
assignee_notified
boolean
required

true when the assignee was e-mailed "task assigned": a new task, or a new assignee, given to someone other than you.