Initiative labels overview

Initiative labels are the workspace-level label catalog for initiatives.

The initiative label object

Attributes

• color string

  Hex color used wherever this is rendered, for example #3f76ff.

• created_at string (date-time)

  When the record was created.

• created_by_id string (uuid)

  The user who created the record.

• description string

  Free-form description.

• id string (uuid)

  Unique identifier.

• name string

  Display name.

• sort_order number

  Manual ordering weight. Lower sorts first.

Response200

{
  "color": "#3f76ff",
  "created_at": "2026-01-14T09:22:41.478363Z",
  "created_by_id": "16c61a3a-512a-48ac-b0be-b6b46fe6f430",
  "description": "What this is for.",
  "id": "b7e42a19-3c5d-4f80-9a26-8d1c0f4e7b53",
  "name": "Example name",
  "sort_order": 65535
}

Endpoints

Method	Path	Description
GET	/api/v2/workspaces/{slug}/initiatives/labels/	List initiative labels
GET	/api/v2/workspaces/{slug}/initiatives/labels/{pk}/	Get an initiative label
POST	/api/v2/workspaces/{slug}/initiatives/labels/	Create an initiative label
PATCH	/api/v2/workspaces/{slug}/initiatives/labels/{pk}/	Update an initiative label
DELETE	/api/v2/workspaces/{slug}/initiatives/labels/{pk}/	Delete an initiative label

Response shaping

Every initiative label read accepts ?fields= for sparse responses — see Sparse fields. Errors follow the shared problem+json contract.