Asset

Reserve an asset upload

Creates one uploading asset and returns a short-lived one-use direct PUT URL.

post/api/spaces/{accountId}/{spaceId}/uploads

Request

  • Base URL: https://makefx.app
  • URL: https://makefx.app/api/spaces/{accountId}/{spaceId}/uploads
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://makefx.app/api/oauth/authorize, token URL https://makefx.app/api/oauth/token, scopes: write)
    • API key in cookie auth_token

Path parameters

accountIdstring required

accountId path parameter

spaceIdstring required

spaceId path parameter

Headers

API-Version'2026-09-10'

The API version the client was written against. Omit it for the current version, 2026-09-10. The response carries the same header, naming the version that answered.

Request body

kind'image' | 'video' | 'audio' required
filenamestring required
mimestring required
size_bytesinteger required
namestring
tagsstring[]
request_idstring

Response

Success

asset_idstring required
upload_urlstring uri required
method'PUT' required
headersobject required
expires_atstring date-time required
next_poll_secondsinteger required
web_urlstring uri required
idempotent_replayboolean

Changes

No recorded changes to this operation across all 1 revision of this API.