Create Label

Create Label allows you to create a new Label in Shortcut.

post/api/v4/{workspace-slug}/labels

Request

  • Base URL: https://api.app.shortcut.com
  • URL: https://api.app.shortcut.com/api/v4/{workspace-slug}/labels
  • Auth: HTTP bearer

Path parameters

workspace-slugstring required

The slug for the Workspace.

Query parameters

fieldsstring

Fields to include in the response, as a comma-separated string. If provided, only these fields will be included for each entity in the response. If not present, all fields will be returned.

Request body

namestring required

The name of the new Label.

colorstring css-color

The hex color to be displayed with the Label (for example, "#ff0000").

descriptionstring

The description of the new Label.

external_idstring

This field can be set to another unique ID. In the case that the Label has been imported from another tool, the ID in the other tool can be indicated here.

Response

Resource

$schemastring required

The URI for the json-schema for this response.

Changes

No recorded changes to this operation across all 1 revision of this API.