Create an initiative label

Creates a new label for categorizing initiatives in a workspace.

POST /api/v1/workspaces/{workspace_slug}/initiatives/labels

Create an initiative label

cURL

curl --request POST \
  --url https://api.plane.so/api/v1/workspaces/{workspace_slug}/initiatives/labels/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "color": "<string>",
  "sort_order": 123
}
'

Path parameters

workspace_slug · string · required

The workspace_slug represents the unique workspace identifier for a workspace in Plane. It can be found in the URL. For example, in the URL https://app.plane.so/my-team/projects/, the workspace slug is my-team.

Body parameters

name · string · required

Name of the initiative label.

description · string

Description of the initiative label.

color · string

Hex color code for the initiative label (e.g., “#eb5757”).

sort_order · number

Sort order for display purposes.