Create Asset Image

POST

/assets/images

Requires to first upload an image file in order to use its file_key.
See Upload Asset Image endpoint

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

API Key

Add parameter in query

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢201Created

application/json

Body

🟠400Bad Request

🟠401Unauthorized API KEY

🟠403Unauthorized roles

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://prod.your-api-server.com/api/core/v2/assets/images' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "file_key": "string",
    "file_hash": "string",
    "name": "string",
    "gravity": "center",
    "locales": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "locale": "en",
            "credit": "string",
            "caption_html": "string"
        }
    ]
}'

Response Example

201 - Example 1

{
    "data": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "file_key": "string",
        "file_hash": "string",
        "name": "string",
        "gravity": "center",
        "locales": [
            {
                "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
                "locale": "en",
                "credit": "string",
                "caption_html": "string"
            }
        ],
        "inserted_at": "2019-08-24T14:15:22Z",
        "updated_at": "2019-08-24T14:15:22Z",
        "deleted_at": "2019-08-24T14:15:22Z"
    }
}

Modified at 2025-06-19 16:40:50

Asset Image by id