Current Priority Orbit derivation for the project

GET

/projects/{id}/prioritization

const url = 'https://example.com/api/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/prioritization';
const options = {method: 'GET', 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 GET \
  --url https://example.com/api/projects/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/prioritization \
  --cookie sb-access-token=<sb-access-token>

Returns the project’s stored topic derivation with each topic’s tickets hydrated LIVE from handoff_requests, so a ticket closed since the derivation is returned with closed: true rather than dropped. derivation: null means the project has never been derived — the portal renders the “Derive topics” empty state.

Authorizations

cookieAuth

Parameters

Path Parameters

required

string format: uuid

Project UUID

Responses

200

Current derivation (or null) with its topics

application/json

object

derivation

required

One of:

null
object

null

topics

required

Array<object>

object

required

string format: uuid

name

required

string

short_name

required

1-3 word label for the orbit node.

string

band

required

When to act — the orbit ring, not the topic’s size.

string

Allowed values: now next watch

outcome

required

string

grouping_reason

required

string

sort_order

required

integer

tickets

required

Array<object>

object

required

string format: uuid

number

required

The in-product HO serial (HO-).

integer

title

required

string

stage

required

string

Allowed values: backlog up_next in_progress validation live

status

required

string

Allowed values: open closed

priority

required

string

Allowed values: low medium high

closed

required

Read live at request time, not frozen with the derivation. A ticket closed since the derivation stays in its topic and renders as done.

boolean

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