Start re-deriving the project's Priority Orbit from its open tickets — deriveprojectprioritization

POST

/projects/{id}/prioritization/derive

const url = 'https://example.com/api/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/prioritization/derive';
const options = {method: 'POST', headers: {cookie: 'sb-access-token=<sb-access-token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/prioritization/derive \
  --cookie sb-access-token=<sb-access-token>

Starts one AI pass over the project’s OPEN tickets to REPLACE the stored derivation and answers 202 immediately with the new run’s id — the model pass itself runs detached from this request and can take minutes on a large project. Poll GET /prioritization/progress for the real phase; GET /prioritization for the finished derivation. Manual only — nothing re-derives on a schedule or on read. Error codes: PRIORITIZATION_NOT_CONFIGURED (503, no Anthropic API key available), NO_OPEN_TICKETS (409, nothing to prioritize), PRIORITIZATION_RUNNING (409, a run is already in flight for this project). A background model failure (PRIORITIZATION_FAILED) surfaces as a failed row on GET /prioritization/progress, not as an HTTP response from this endpoint.

Authorizations

cookieAuth

Parameters

Path Parameters

required

string format: uuid

Project UUID

Responses

202

The derivation started; the model pass continues in the background

application/json

The derivation was accepted and started; the model pass continues detached from this response. Poll GET /prioritization/progress with run_id to follow it.

object

run_id

required

string format: uuid

phase

required

string

Allowed values: starting

401

Not authenticated

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

reconnect

True if re-linking GitHub may fix the issue

boolean

403

Forbidden

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

409

The project has no open tickets to prioritize, or a derivation is already running

429

Rate limited

application/json

object

error

required

Human-readable error message

string

code

Stable machine-readable error code for client branching

string

fieldErrors

First validation message per field path

object

key

additional properties

string

issues

Structured validation issues (Zod)

Array<object>

object

path

required

string

message

required

string

retryAfter

Seconds until rate limit resets (429 responses)

number

retryAfter

Seconds until the rate limit resets

number

Headers

Retry-After

string

503

No API key configured