Live phase of the in-flight Priority Orbit derivation — getprojectprioritizationprogress

GET

/projects/{id}/prioritization/progress

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

What the derive pass is doing right now, so the portal button can name the real backend phase instead of guessing from a timer. Polled every 2s while a derivation runs. phase: null means the project has no run on record. stale: true means the run has not moved for longer than the model budget plus a minute of grace (PROGRESS_STALE_AFTER_MS, lib/prioritization/progress.ts) and must not be waited on. Plain polling, not a realtime channel: one row, one reader, one bounded model pass. A saved result stays done if its follow-up read fails; the portal retries that read without starting another analysis. The write side is best-effort: a failed or slow progress write never fails, slows or changes the outcome of a derivation.

Authorizations

cookieAuth

Parameters

Path Parameters

required

string format: uuid

Project UUID

Responses

200

The project’s current derivation run, or an all-null shape when there is none

application/json

One project’s current derivation run. Every field is null when the project has no run on record.

object

run_id

required

Identifies one derivation attempt, so a poller can tell its own run from someone else’s.

string | null format: uuid

phase

required

What the server is doing. done and failed are terminal — the page stops polling. null means no run has ever been recorded for this project.

string | null

Allowed values: starting loading_tickets grouping saving done failed

detail

required

Human-facing specific for the phase, rendered into the button label: the open-ticket count (loading_tickets), the model name (grouping), the topic count (saving), or the typed error’s name (failed).

string | null

started_at

required

string | null format: date-time

updated_at

required

string | null format: date-time

stale

required

updated_at is older than the model budget plus a minute of grace (PROGRESS_STALE_AFTER_MS) on a non-terminal phase — the run died between phases and should not be waited on.

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

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