Skip to main content
GET
https://postsyncer.com/api/v1
labels
/
{id}
curl -X GET "https://postsyncer.com/api/v1/labels/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{ 
  "id": 16,
  "name": "Product Launch",
  "color": "#ff0000",
  "workspace": {
      "id": 12,
      "name": "abdulmejidshemsuawel",
      "slug": "abdulmejidshemsuawel",
      "type": "PERSONAL",
      "logo": null,
      "timezone": "Africa/Addis_Ababa",
      "language": "en"
  } 
}

​
Get Label

Retrieves detailed information about a specific label, including its name, color, and associated workspace.

​
Request

​
id
integer
required
The ID of the label to retrieve
curl -X GET "https://postsyncer.com/api/v1/labels/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Response

​
id
integer
Unique identifier for the label
​
name
string
The name of the label
​
color
string
The hex color code of the label
​
workspace
object
Information about the label’s workspace
​
created_at
string
Creation timestamp in workspace timezone
​
updated_at
string
Last update timestamp in workspace timezone
{ 
  "id": 16,
  "name": "Product Launch",
  "color": "#ff0000",
  "workspace": {
      "id": 12,
      "name": "abdulmejidshemsuawel",
      "slug": "abdulmejidshemsuawel",
      "type": "PERSONAL",
      "logo": null,
      "timezone": "Africa/Addis_Ababa",
      "language": "en"
  } 
}

​
Code Examples

curl -X GET "https://postsyncer.com/api/v1/labels/123" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

​
Error Codes

​
401
Unauthorized
Missing or invalid API token
​
403
Forbidden
Token does not have ‘labels’ permission
​
404
Not Found
Label not found or user does not have access to the label’s workspace