v1

latestOpenAPI 3.1.02026-07-2618690613.4 KB
Labels

Get label

Retrieve a single label by name.

get/v1/labels/{labelName}

Path parameters

labelNamestring required

The label name. Lookup is case-insensitive.

URL-encode special characters (e.g., In%20Review for "In Review").

Response

Label details

namestring

The label name (2-25 characters).

Names are case-insensitive: "Production" and "production" are considered the same.

verifiedboolean

Whether the label is verified/curated

homepageboolean

Whether the label appears on the organization homepage

usage_countinteger

Total number of documents and folders using this label

colorstring

Hex color for the label

descriptionstring

Description of the label

Example response

{
  "name": "Production",
  "verified": true,
  "usage_count": 12,
  "color": "#0366d6",
  "description": "Documents based on dev schemas"
}