Applied LabsDocs
Inbound

Upload media

Upload a file (image, document, audio, etc.) to your Applied workspace. Use the returned `id` in the `attachments` array of `POST /v2026-04/messages/` to attach the file to an inbound message.

POST/v2026-04/media/

Usage

Start from this cURL example and add filters as needed.

cURL
curl -X POST https://core.appliedlabs.ai/v2026-04/media/ \
  -H "Authorization: Bearer <api-token>" \
  -H "X-Shop-Id: 66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10" \
  -H "Content-Type: multipart/form-data" \
  --data '{
  "file": "https://core.appliedlabs.ai/resource",
  "permission": "public"
}'

Authorizations

Authorizationstringheaderrequired

Send your Applied API key as Authorization: Bearer AL.... Create the key in the Applied dashboard and keep it on your server.

Header parameters

X-Shop-Idstring · uuidrequired

The shop whose data you want to read.

Body

multipart/form-data
required
filestring · urirequired

The file to upload.

permissionallOf

Whether the file should be readable from a public URL. Defaults to "public".

privatepublic
Generated Examplemultipart/form-data
{
  "file": "https://core.appliedlabs.ai/resource",
  "permission": "public"
}

Response

The uploaded media record.

created_atstring · date-timerequired
idstring · uuidrequired
original_namestring
permissionenum<string>
privatepublic
typestringrequired
urlstringrequired

Direct download URL for the uploaded file. May be a signed URL with limited lifetime.

{
  "created_at": "2026-04-07T14:30:00Z",
  "id": "66e4c4d2-34e8-4f85-8f51-84b6ed7b5f10",
  "original_name": "string",
  "permission": "private",
  "type": "string",
  "url": "string"
}