List all post statuses

GET/v2/post_statuses

Returns all post statuses for the authenticated organization.

Post statuses define workflow stages for posts. Each status has:

A display name and color
A type indicating the workflow stage (reviewing, unstarted, active, completed, canceled)
A flag indicating if it’s the default status for new posts

This endpoint returns all post statuses without pagination. Organizations typically have a small number of statuses.

Header ParametersExpand Collapse

"Featurebase-Version": optional "2026-01-01.nova" or "2025-12-12.clover"

One of the following:

"2026-01-01.nova"

"2025-12-12.clover"

ReturnsExpand Collapse

id: string

Unique identifier

color: string

Color for UI display

isDefault: boolean

Whether this is the default status for new posts

name: string

Display name

object: "post_status"

Object type identifier

type: "reviewing" or "unstarted" or "active" or 2 more

The workflow stage this status represents

One of the following:

"reviewing"

"unstarted"

"active"

"completed"

"canceled"

List all post statuses

curl https://do.featurebase.app/v2/post_statuses \
    -H "Authorization: Bearer $FEATUREBASE_API_KEY"

[
  {
    "id": "507f1f77bcf86cd799439011",
    "color": "Blue",
    "isDefault": false,
    "name": "In Progress",
    "object": "post_status",
    "type": "active"
  }
]

Returns Examples

[
  {
    "id": "507f1f77bcf86cd799439011",
    "color": "Blue",
    "isDefault": false,
    "name": "In Progress",
    "object": "post_status",
    "type": "active"
  }
]