Media

Client uploads are scoped under <projectId>/user/<appUserId>/<ms>_<filename> in the storage path — they can't collide with admin-uploaded assets.

Source: apps/api/src/routes/client/media.ts.

Endpoints

Method	Path	Description
GET	`/client/media/:assetId`	Fetch a single asset (public columns).
GET	`/client/media`	Paginated asset list; optional `?folder_id=`.
POST	`/client/media/upload`	Register an upload; returns `upload_url`.

GET /client/media/:assetId

Response 200

{
  "data": {
    "id": "…",
    "filename": "…",
    "mime_type": "image/png",
    "storage_url": "…",
    "thumbnail_url": null,
    "alt_text": null,
    "metadata": {}
  }
}

Errors

404 NOT_FOUND.

Try it:

GET/client/media/%7B%7BassetId%7D%7D

client auth

curl -X GET 'https://api.amba.dev/client/media/%7B%7BassetId%7D%7D'

Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/media/{assetId}' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

GET /client/media

Query

Param	Default	Description
`limit`	50
`offset`	0
`folder_id`	—	Filter.

Response 200

{
  "data": [{ "id": "…", "filename": "…", "storage_url": "…" }],
  "total": 42,
  "offset": 0,
  "limit": 50
}

Try it:

GET/client/media

client auth

curl -X GET 'https://api.amba.dev/client/media'

Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X GET '${BASE_URL}/client/media' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}'

POST /client/media/upload

Request

Field	Type	Required
`filename`	string	yes
`mime_type`	string	yes
`size_bytes`	number	no

Response 201

{
  "data": {
    "id": "…",
    "filename": "…",
    "storage_url": "https://storage.amba.dev/…",
    "uploaded_by": "<appUserId>"
  },
  "upload_url": "https://storage.amba.dev/…?upload=true"
}

Errors

500 CREATE_FAILED.

Try it:

POST/client/media/upload

client auth

curl -X POST 'https://api.amba.dev/client/media/upload'

Loading auth… Configure auth in the settings drawer (top-right) to run this request.

Curl:

curl -X POST '${BASE_URL}/client/media/upload' \
  -H 'X-Api-Key: ${CLIENT_API_KEY}' \
  -H 'Authorization: Bearer ${SESSION_TOKEN}' \
  -H 'Content-Type: application/json' \
  -d '{}'

On this page