Clear label

Production

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

PUT

/labels/{labelId}/clear

Removes the label from all newsobjects.
This means the label will be deleted and recreated while keeping the collaboration options.

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:

offline_access-Offline access

openid-OpenID

profile-Profile

email-Email

Path Params

Responses

🟢200OK

application/json

Body

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.belga.press/belgapress/api/labels//clear'

Response Example

200 - Example 1

{
    "collaboration": {
        "type": "PRIVATE",
        "owners": [
            {
                "userId": 0,
                "firstName": "string",
                "lastName": "string",
                "email": "user@example.com",
                "organizationName": "string"
            }
        ],
        "editors": [
            {
                "userId": 0,
                "firstName": "string",
                "lastName": "string",
                "email": "user@example.com",
                "organizationName": "string"
            }
        ]
    },
    "id": 0,
    "name": "string",
    "order": 0,
    "parentId": 0,
    "type": "LABEL"
}

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

Update label

Delete label collaborators