Categories
Posts can be assigned categories. Use the API to list, retrieve, create, and delete categories for your organization.
Posts can be assigned categories — short labels like "UI", "API", or "Performance" that classify what a feedback or roadmap post is about. Each category belongs to your organization and can be applied to posts on any board.
The API lets you list, retrieve, create, and delete categories. To change the category assigned to a specific post, see the feedback posts update endpoint (covered in a future Phase 5d-b page).
Behavior differences from Canny. ProductBridge categories are organization-scoped — one set of categories applies to every board in the org, instead of being defined per-board. Sub-categories (Canny's parentID) are not supported in v1; every category is top-level.
The category object
A unique identifier for the category (UUID).
The display name of the category. May be null for system-managed categories that haven't been renamed.
An auto-generated, slug-like identifier derived from the name (e.g. "ui" for "UI"). Useful for stable references in scripts. May be null.
Optional human-readable description shown in the dashboard. May be null.
Optional hex color string (e.g. "#3B82F6") used as a visual badge in the dashboard. May be null.
Whether this category appears in the dashboard's feedback views.
Whether this category appears in the dashboard's roadmap views.
ISO 8601 timestamp at which the category was created.
Example category object
{
"id": "553c3ef8-b8cd-cd15-01ba-12bb12bb12bb",
"name": "UI",
"code": "ui",
"description": "User interface and visual design feedback.",
"color": "#3B82F6",
"show_on_feedback": true,
"show_on_roadmap": true,
"created_at": "2026-05-09T13:14:22.389Z"
}
What you can do
Retrieve a category
Look up the full details of a single category by its UUID.
List categories
Return every active category for the authenticated organization.
Create a category
Add a new category. Names are 1–30 characters.
Delete a category
Soft-delete a category. Posts that referenced it have their category_id cleared automatically.
Last updated 1 week ago
Built with Documentation.AI