API reference / media

Import media from URL

POST/v1/mediaPermission posts:write

Imports an image or video from an external public URL into Foxli CDN storage (images ≤ 10 MB, videos ≤ 100 MB).

Headers

AuthorizationstringREQUIRED

Bearer followed by your API key.

Foxli-Workspacestring

Target workspace ID. Required if account owns or admins more than one workspace.

Idempotency-Keystring

Unique token for request idempotency (valid for 24 hours).

Query parameters

workspace_idstring

Alternative way to pass workspace ID.

Body parameters

urlstringREQUIRED

kindstring

imagevideo

Errors

400workspace_requiredInvalid request parameters or missing workspace context.

curl -X POST https://api.foxli.app/v1/media \
  -H "Authorization: Bearer $FOXLI_API_KEY" \
  -H "Foxli-Workspace: ws_brand_primary" \
  -H "Idempotency-Key: idemp_9f82a1" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe",
  "kind": "image"
}'

Response201 OK

{
  "success": true
}

Build on Foxli.

Publish posts, sync social channels, stream analytics, and get instant webhooks.

Start free for 30 days API Reference

No card for month one · Cancel anytime