List Labels

GET

/labels/

Retrieves a paginated list of all labels (tags) in your workspace. Labels are used to organize and categorize posts, making it easier to filter and manage your content calendar. Each label has a name and an optional color for visual identification in the interface.

Notes

Labels are workspace-specific - you can only see labels from your own workspace.

Use the label IDs when creating or updating posts to tag them with specific labels.

Labels help organize your content calendar and can be used to filter posts in the GET /posts endpoint.

Labels are also available within Insights Posts, allowing filter and agregate analytical data.

The color field is optional and used for visual identification in the user interface.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.swonkie.dev/v2/labels/?skip=0&take=100' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '

Response Example

{
    "items": [
        {
            "id": "TGFiZWxJZDExMTExMTEx",
            "name": "Product Launch",
            "color": "#FF5733"
        },
        {
            "id": "TGFiZWxJZDIyMjIyMjIy",
            "name": "Marketing Campaign",
            "color": "#00BFFF"
        },
        {
            "id": "TGFiZWxJZDMzMzMzMzMz",
            "name": "Social Media",
            "color": "#32CD32"
        }
    ],
    "total": 15,
    "skip": 0,
    "take": 20
}

Modified at 2026-06-19 17:25:23

Getting Started

Create a Label

List Labels

Notes#

Request

Responses

Notes