Upload Asset Image

Omerlo CA

https://assets.ca.omerlo.app

POST

/upload/image

Uploads an image file to temporary storage and returns its key

Accepted image file formats: "jpg", "jpeg", "gif", "png", "webp"
Max supported file size: 15 MB

We encourage you to optimize the size of your files before uploading

The returned key is temporary: the file is deleted after 24 hours.
Attach it right away by sending it in a resource's ..._key field (e.g. profile_image_key),
or as file_key to Create Asset Image.
See How to upload an image and use it.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Body Params multipart/form-data

Responses

🟢200Success

application/json

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized API KEY

🟠403Unauthorized roles

🟠413File size limit exceeded

🔴500Something went wrong

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://assets.ca.omerlo.app/upload/image' \
--header 'x-api-key: <api-key>' \
--form 'image=@""'

Response Example

200 - Example 1

{
    "data": {
        "key": "uploads/1df110ad-0b57-45cd-9ca9-8850f067e7ef/91c1d1f4-b87f-44cb-9773-24a9ad1df060.jpg"
    }
}

Modified at 2026-10-02 07:57:53

How to upload an image and use it

Get Asset Image by key