Management API / Media

Upload media

POST/api/manage/v1/media

Uploads one file to the media library. Limited to 30 uploads per minute per key, on top of the surface-wide limit.

Authorization

Authorizationheaderrequired
Bearer jfk_…: an API key created in Admin → Settings → API.
Required capabilitymedia:upload
The key and its owner must both hold it. Content scopes on the key are applied to this request as well.

multipart/form-data

filefilerequired
The file to upload. Size is capped by the site's upload limit.

201Created
401Missing, unknown, revoked, expired, or out-of-scope key.
403The key or its owner lacks the required capability or scope.
429Per-key or per-IP rate limit exceeded. Wait for the seconds in Retry-After.

Upload media

curl -X POST "https://your-site.example/api/manage/v1/media" \
  -H "Authorization: Bearer $JF_KEY" \
  -F "file=@./hero.jpg"

Response

{
  "error": "Unauthorized"
}