Post Statuses

Get a post status by ID

Retrieves a single post status by its unique identifier.

GET

/v2/post_statuses/{id}

curl --request GET \
  --url https://do.featurebase.app/v2/post_statuses/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit'

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

Returns the full post status object including name, color, type, and default flag.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Path Parameters

idstringrequired

Post status unique identifier

Example: 507f1f77bcf86cd799439011

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Response

Success

colorstringrequired

Color for UI display

Example: Blue

idstringrequired

Unique identifier

Example: 507f1f77bcf86cd799439011

isDefaultbooleanrequired

Whether this is the default status for new posts

Example: false

namestringrequired

Display name

Example: In Progress

objectenum<string>required

Object type identifier

Available options: post_status

Example: post_status

typeenum<string>required

The workflow stage this status represents

Available options: reviewing, unstarted, active, completed, canceled

Example: active

Still need help? Ask the team