Fetch user labels

Production

https://api.belga.press/belgapress/api

GET

/users/{userId}/labels

Fetches all private, shared and organization labels the user can access.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://sso.ssl.belga.be/auth/realms/belga/protocol/openid-connect/auth

Token URL: https://sso.ssl.belga.be/auth/realms/belga/protocol/openid-connect/token

Scopes:

openid

offline_access

profile

email

Path Params

Query Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.belga.press/belgapress/api/users//labels?count&offset&type&collaborationtypes' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "_links": {
        "next": "http://example.com",
        "prev": "http://example.com",
        "self": "http://example.com"
    },
    "_meta": {
        "total": 0
    },
    "data": [
        {
            "collaboration": {
                "editors": [
                    {
                        "email": "user@example.com",
                        "firstName": "string",
                        "lastName": "string",
                        "organizationName": "string",
                        "userId": 0
                    }
                ],
                "owners": [
                    {
                        "email": "user@example.com",
                        "firstName": "string",
                        "lastName": "string",
                        "organizationName": "string",
                        "userId": 0
                    }
                ],
                "type": "PRIVATE"
            },
            "id": 0,
            "name": "string",
            "order": 0,
            "parentId": 0,
            "type": "LABEL"
        }
    ]
}

Modified at 2025-11-05 16:04:27

Delete label collaborators

PUT user labels order