Upload file

Production

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

POST

/uploads/files

Uploads a file with metadata.

The request body must be provided as multipart/form-data.
The response returns a JSON object including the CDN url of the uploaded file.

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

Body Params multipart/form-data

Responses

🟢201Created

application/json

Created

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.belga.press/belgapress/api/uploads/files' \
--header 'Authorization: Bearer <token>' \
--form 'assetType=""' \
--form 'belgaImageUuid=""' \
--form 'data=@""' \
--form 'fileName=""' \
--form 'fileType=""'

Response Example

201 - Example 1

{
    "id": 0,
    "url": "http://example.com",
    "assetType": "BELGA_IMAGE",
    "belgaImageUuid": "string",
    "fileName": "string",
    "fileSize": 0,
    "fileType": "DOCX",
    "cropzone": {
        "x": 0,
        "y": 0,
        "width": 0,
        "height": 0
    }
}

Modified at 2025-11-06 15:15:30

Upload media

Update file metadata