Skip to main content
PUT
Set thread goal.

Authorizations

Authorization
string
header
required

Bearer JWT token or API Key (sk-*).

Path Parameters

id
string
required

Body

application/json
objective
string
required

Durable thread-level objective used to validate assistant completion across turns, tool loops, approval resumes, and compaction.

Required string length: 1 - 4000
successCriteria
string[]

Optional concrete criteria the goal reviewer should require before marking the goal satisfied.

Maximum array length: 20
nonGoals
string[]

Optional exclusions that should not be treated as required work for this goal.

Maximum array length: 20
requiredEvidence
string[]

Optional evidence the reviewer should expect, such as tests, lint, screenshots, API results, or changed resources.

Maximum array length: 20
validationCommands
string[]

Optional validation commands or checks relevant to this goal.

Maximum array length: 20
doneDefinition
string

Optional concise definition of done used by the reviewer when evaluating candidate completion.

Maximum string length: 500

Response

Thread goal updated.

Last modified on September 5, 2026