StatusesOverview

Statuses

Per-organization workflow statuses for feedback and roadmap posts (open, in-progress, completed, closed).

Statuses represent where a post is in your team's workflow. ProductBridge groups statuses into four standard buckets — open, in-progress, completed, closed — and each organization can define one or more named statuses inside each bucket (e.g. "Under review" inside open, "Building" inside in-progress).

The API lets you list the org's statuses. Use the returned status id when calling endpoints that filter by status (such as list feedback posts) or set status (such as update feedback post).

Creating, renaming, or reordering statuses is dashboard-only in v1 — there is no public API for status mutation.

The status object

idstring
Required

A unique identifier for the status (UUID).

namestring

The display name (e.g. "Under review"). May be null.

codestring

Auto-generated slug-like identifier. May be null.

colorstring

Hex color string for the status badge in the dashboard. May be null.

status_group_codestring
Required

Workflow bucket this status belongs to. One of "open", "in-progress", "completed", "closed".

is_default_statusboolean
Required

Whether this status is the default assigned to newly-created posts.

show_on_feedbackboolean
Required

Whether this status appears in feedback views.

show_on_roadmapboolean
Required

Whether this status appears in roadmap views.

created_atstring
Required

ISO 8601 timestamp at which the status was created.

Example status object

{
  "id": "883c3ef8-b8cd-cd15-01ba-status000001",
  "name": "Under review",
  "code": "under-review",
  "color": "#3B82F6",
  "status_group_code": "open",
  "is_default_status": true,
  "show_on_feedback": true,
  "show_on_roadmap": true,
  "created_at": "2026-03-15T09:00:00.000Z"
}

What you can do

List statuses

Return every active status for the authenticated organization, ordered by workflow group.

Was this page helpful?

Last updated 2 weeks ago

Built with Documentation.AI