👋 Welcome to the new Omni docs! We're still migrating, but the old docs are available at docs-legacy.omni.co.
cURL
curl --request GET \ --url https://{instance}.omniapp.co/api/v1/labels \ --header 'Authorization: Bearer <token>'
{ "labels": [ { "name": "Production", "verified": true, "homepage": true, "usage_count": 12 }, { "name": "In Review", "verified": true, "homepage": false, "usage_count": 5 }, { "name": "Draft", "verified": false, "homepage": false, "usage_count": 3 } ] }
Retrieve all labels in the organization.
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Authorization
Bearer YOUR_TOKEN
List of all labels in the organization
Show child attributes
The label name (2-25 characters).
Names are case-insensitive: "Production" and "production" are considered the same.
"Production"
"production"
Whether the label is verified/curated
true
Whether the label appears on the organization homepage
false
Total number of documents and folders using this label
12
Was this page helpful?