Skip to main content
PATCH
Update Task

Authorizations

X-Lightsage-Api-Key
string
header
required

Path Parameters

task_id
string
required

Body

application/json

Update the status and delegation of a single task.

All fields are optional so status transitions and delegation can be changed independently. Only the fields present in the request body are changed; omitted fields are left unchanged. Setting assignee_user_id or action_type to null clears it. Send at least one field.

status
enum<string>
Available options:
new,
in_progress,
added_to_sheet,
done,
dismissed,
snoozed
priority
enum<string>
Available options:
urgent,
high,
medium,
low
assignee_user_id
string
action_type
enum<string>
Available options:
agent_discovery,
agent_usability

Response

Successful Response

A single persisted daily task in the public contract shape.

id
string
required
action_date
string
required
batch_number
integer
required
rank
integer
required
source_key
string
required
task_type
string
required
title
string
required
why
string
required
next_action
string
required
execution_prompt
string
required

Paste-ready instructions for an AI agent to execute this task.

score
number
required
effort
string
required
status
string
required
source_type
string
required
description
string | null
reasoning
string | null
evidence
Evidence · object
priority
string | null
assignee_user_id
string | null
function_area
string | null
action_type
string | null
source
string | null
source_refs
Source Refs · object
metadata
Metadata · object
created_at
string | null
updated_at
string | null