Media

Register a presigned upload

Adds a file you uploaded with POST /v0/media/presign (intent post) + HTTP PUT to the media library in place — no second copy is stored — and returns the media record. Pass the presign key. The object's type and size are read from storage and must be an allowed image/video/audio type within the post upload limit (250 MB). Idempotent: registering the same key again returns the existing record. Returns 404 when no uploaded object exists for the key in your workspace.

post/v0/media/register

Request

  • Base URL: https://api.schedulin.app
  • URL: https://api.schedulin.app/v0/media/register
  • Auth: one of:
    • API key in header x-api-key
    • OAuth 2 (authorization code, authorization URL https://api.schedulin.app/oauth/authorize, token URL https://api.schedulin.app/oauth/token, scopes: media:write)

Request body

keystring required

The key returned by POST /v0/media/presign, after the bytes were PUT to its url. The stored media URL for that key is also accepted.

namestring
altstring nullable

Response

OK

idstring required
urlstring required
namestring required
mimeTypestring required
widthinteger nullable required
heightinteger nullable required
durationinteger nullable required
createdAtstring date-time required
updatedAtstring date-time required
bucketstring required
keystring required
sizeinteger nullable required
altstring nullable required
thumbnailUrlstring nullable required

Changes

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