curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/classification-labels \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/classification-labels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/classification-labels"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Classification labels retrieved successfully",
"pagination": {
"limit": 20,
"next_cursor": "NjZmMWE4YzNlNGIwYTFiMmMzZDRlNWY2"
}
},
"data": [
{
"_id": "6729d0a1b2c3d4e5f6a7b8c9",
"organizationId": "66a0f1e2d3c4b5a697887766",
"name": "Pricing questions",
"description": "Emails asking about prices, discounts, quotes or billing terms.",
"isActive": true,
"color": "teal",
"labels": [
{
"_id": "6729d1e2f3a4b5c6d7e8f901",
"name": "Discount request"
},
{
"_id": "6729d1e2f3a4b5c6d7e8f902",
"name": "Quote request"
}
],
"createdBy": "66a0f1e2d3c4b5a697881111",
"createdAt": "2026-11-04T09:30:00.000Z",
"updatedAt": "2026-11-04T09:30:00.000Z"
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}List label groups
Returns the workspace’s label groups with their labels, newest first.
By default the list pages with a cursor: pass limit, then send meta.pagination.next_cursor
back as cursor for the next page. Sending page switches to page-number paging, sorted by
creation date (newest first), with meta.pagination holding page, limit, totalPages,
count and hasMore. See Pagination.
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/classification-labels \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/classification-labels', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/classification-labels"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Classification labels retrieved successfully",
"pagination": {
"limit": 20,
"next_cursor": "NjZmMWE4YzNlNGIwYTFiMmMzZDRlNWY2"
}
},
"data": [
{
"_id": "6729d0a1b2c3d4e5f6a7b8c9",
"organizationId": "66a0f1e2d3c4b5a697887766",
"name": "Pricing questions",
"description": "Emails asking about prices, discounts, quotes or billing terms.",
"isActive": true,
"color": "teal",
"labels": [
{
"_id": "6729d1e2f3a4b5c6d7e8f901",
"name": "Discount request"
},
{
"_id": "6729d1e2f3a4b5c6d7e8f902",
"name": "Quote request"
}
],
"createdBy": "66a0f1e2d3c4b5a697881111",
"createdAt": "2026-11-04T09:30:00.000Z",
"updatedAt": "2026-11-04T09:30:00.000Z"
}
]
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}heliyos_labels_list.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Query Parameters
Groups per page, 1 to 100. Defaults to 20.
1 <= x <= 100The next_cursor from the previous page. When sent, page is ignored.
next_cursor from the previous page; only valid with the default sort.
200A page number, starting at 1, for page-number paging. Pages are limit groups long.
x >= 1Text to match, case-insensitive and literally, in the group's name, its description or any of its labels' names. Up to 200 characters.
200true lists only active groups, false only paused ones. Omit for both.
Was this page helpful?

