Statuses API reference

This is the reference for the Statuses endpoints of the Quackback REST API: every endpoint, its parameters, request fields and response fields. It is generated from the API's OpenAPI description, so it matches what the API accepts.

All paths are relative to /api/v1 on your workspace's address (for example https://feedback.example.com/api/v1). Authenticate with an API key in the Authorization: Bearer qb_... header. For keys, errors, pagination and rate limits, see API overview. Every workspace also serves an interactive reference at /api/v1/docs.

Endpoints

• GET /statuses: List statuses
• POST /statuses: Create a status
• GET /statuses/{statusId}: Get a status
• PATCH /statuses/{statusId}: Update a status
• DELETE /statuses/{statusId}: Delete a status

List statuses

GET /api/v1/statuses

Returns all statuses in the workspace, ordered by category and position

Response 200: returns id, name, slug, color, category, position, showOnRoadmap, isDefault, createdAt.

Create a status

POST /api/v1/statuses

Create a new post status

Request body

Response 201: returns id, name, slug, color, category, position, showOnRoadmap, isDefault, createdAt.

Get a status

GET /api/v1/statuses/{statusId}

Get a single status by ID

Parameters

Response 200: returns id, name, slug, color, category, position, showOnRoadmap, isDefault, createdAt.

Update a status

PATCH /api/v1/statuses/{statusId}

Update an existing status. Note: slug, category, and position cannot be changed via this endpoint.

Parameters

Request body

Response 200: returns id, name, slug, color, category, position, showOnRoadmap, isDefault, createdAt.

Delete a status

DELETE /api/v1/statuses/{statusId}

Delete a status by ID. Cannot delete the default status or a status with assigned posts.

Parameters