v1

latestOpenAPI 3.1.02026-07-2617125852.3 KB

CustomTag

Get custom tag

Requires one of the following scopes: custom_tags:read, custom_tags:all, all:read, all:all

get/api/v2/custom-tags/{id}

Path parameters

idstring uuid required

Example:019f94cd-ae67-71be-880d-fd79ca9af4b8

The ID of the requested item

Response

The requested Custom Tag

idstring uuid required

Unique identifier for the custom tag

timestamp_createdstring date-time required

Timestamp when the custom tag was created

timestamp_updatedstring date-time required

Timestamp when the custom tag was last updated

organization_idstring uuid required

Organization ID that owns this custom tag

labelstring required

Display label for the custom tag. Must be unique per workspace after trimming whitespace.

descriptionstring nullable

Detailed description of the custom tag purpose

Example response

{
  "id": "019f94cd-83c1-7baf-8a0d-b05c07849384",
  "timestamp_created": "2026-07-24T15:45:24.417Z",
  "timestamp_updated": "2026-07-24T15:45:24.417Z",
  "organization_id": "019f94cd-83c1-7baf-8a0d-b05dd9a6b0e3",
  "label": "Important",
  "description": "Used for marking important items"
}