Skip to main content
POST
Decide on a work item

Authorizations

Authorization
string
header
required

Authorization: Bearer YOUR_API_KEY. /v2 accepts no other method.

Path Parameters

number
integer
required

Body

application/json
type
enum<string>
required
Available options:
start,
approve,
request_changes,
answer,
release,
complete,
close,
hold_back,
reopen
stage
enum<string>
Available options:
spec,
plan,
build
goal
enum<string>

How far to go without a person: the work item moves on by itself up to this stage. Not before stage; defaults to it.

Available options:
spec,
plan,
build
text
string

Markdown.

Maximum string length: 10000
until
string<date>
Example:

"2026-12-01"

Response

OK

The entry the call wrote, or the first one for a repeated report, and the work item as it is now.

status
string
data
object