Endpoints
Use the labels endpoints to list, create, update, and delete labels owned by the authenticated user or workspace. The response shape is documented on the Label object page.
GET /labels
List all labels owned by the authenticated caller.
Query parameters
| Field | Type | Description |
|---|---|---|
| limit | number | Page size. Defaults to 20 and cannot exceed 100. |
| cursor | string | Pagination cursor returned by a previous list response. |
Example request
curl --request GET \
--url 'https://api.feedhive.com/labels?limit=20' \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'Response body
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded. |
| data.items | Label[] | Returned label records for this page. |
| data.total | number | Total number of labels owned by the caller. |
| data.has_more | boolean | Whether another page of labels is available. |
| data.next_cursor | string | null | Cursor for the next page, or null when there are no more results. |
GET /labels/:id
Fetch a single label by ID.
Path parameters
| Field | Type | Description |
|---|---|---|
| id | string | Label identifier. |
Example request
curl --request GET \
--url https://api.feedhive.com/labels/lbl_campaign_q4 \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'Response body
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded. |
| data | Label | Requested label record. |
POST /labels
Create a new label.
Request body
| Field | Type | Description |
|---|---|---|
| title | string | Required. Label name. Must be a non-empty string. |
Example request
curl --request POST \
--url https://api.feedhive.com/labels \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"title": "Campaign Q4"
}'Response body
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded. |
| data | Label | Created label record. |
PATCH /labels/:id
Update an existing label.
Path parameters
| Field | Type | Description |
|---|---|---|
| id | string | Label identifier. |
Request body
| Field | Type | Description |
|---|---|---|
| title | string | New label name. Must be non-empty when provided. |
Example request
curl --request PATCH \
--url https://api.feedhive.com/labels/lbl_campaign_q4 \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"title": "Campaign Q1"
}'Response body
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded. |
| data | Label | Updated label record. |
DELETE /labels/:id
Delete a label.
Path parameters
| Field | Type | Description |
|---|---|---|
| id | string | Label identifier. |
Example request
curl --request DELETE \
--url https://api.feedhive.com/labels/lbl_campaign_q4 \
--header 'accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'Response body
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request succeeded. |
| data | Label | Deleted label record. |