Skip to main content
GET
https://postsyncer.com/api/v1
labels
curl -X GET "https://postsyncer.com/api/v1/labels" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "id": 1,
      "name": "Product Launch",
      "color": "#ff0000",
       "workspace": {
          "id": 12,
          "name": "abdulmejidshemsuawel",
          "slug": "abdulmejidshemsuawel",
          "type": "PERSONAL",
          "logo": null,
          "timezone": "Africa/Addis_Ababa",
          "language": "en"
      }
    },
    {
      "id": 2,
      "name": "Winter",
      "color": "#0000ff",
       "workspace": {
          "id": 12,
          "name": "abdulmejidshemsuawel",
          "slug": "abdulmejidshemsuawel",
          "type": "PERSONAL",
          "logo": null,
          "timezone": "Africa/Addis_Ababa",
          "language": "en"
      }
    }
  ]
}

List Labels

Retrieves all labels from workspaces that the authenticated user has access to.

Request

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

Response

data
array
Array of label objects
{
  "data": [
    {
      "id": 1,
      "name": "Product Launch",
      "color": "#ff0000",
       "workspace": {
          "id": 12,
          "name": "abdulmejidshemsuawel",
          "slug": "abdulmejidshemsuawel",
          "type": "PERSONAL",
          "logo": null,
          "timezone": "Africa/Addis_Ababa",
          "language": "en"
      }
    },
    {
      "id": 2,
      "name": "Winter",
      "color": "#0000ff",
       "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" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Error Codes

401
Unauthorized
Missing or invalid API token
403
Forbidden
Token does not have ‘labels’ permission