ComRaidComRaid Docs
API referenceMedia

Upload a push image

Multipart upload of a JPEG or PNG (max 1MB). Field name must be `file`. Returns a project-scoped `asset_id` and a publicly reachable `url` suitable for `content.push.image_url`. Requires S3-compatible storage configuration. Dashboard session uploads use `/dashboard/projects/{projectId}/media` and are not part of this public specification.

POST
/media

Multipart upload of a JPEG or PNG (max 1MB). Field name must be file. Returns a project-scoped asset_id and a publicly reachable url suitable for content.push.image_url. Requires S3-compatible storage configuration. Dashboard session uploads use /dashboard/projects/{projectId}/media and are not part of this public specification.

Authorization

bearerAuth
headerAuthorizationBearer <API key>

Project API key (cr_sk_...)

Request Body

multipart/form-data
  1. body
file*unknown

JPEG or PNG image, max 1MB

Response Body

Uploaded

application/json
  1. response
asset_id*string

Stable media asset id for this project

Formatuuid
url*string

Public URL for content.push.image_url

Formaturi
Example Request
curl -X POST 'https://api.comraid.io/media' \  -F 'file=null'
Example Response
{  "asset_id": "33333333-3333-4333-8333-333333333333",  "url": "https://cdn.example.com/organizations/.../images/33333333-3333-4333-8333-333333333333.png"}