Skip to main content
POST
POST /uploads/{id}/capability
Required permissions: library.upload. Returns temporary upload instructions for an existing upload session: data.method is PUT, data.url is the destination, and data.headers contains the headers to copy. Create a separate PUT request in Postman using the complete returned URL. Select Authorization → No Auth and Body → binary, copy the returned headers, and select your original file. Do not send the file to this capability endpoint and do not send your Platform API key to the PUT URL. See the full Postman upload steps. Send an Idempotency-Key. This endpoint gives fresh upload instructions; calling it again does not extend the upload session’s original 15-minute deadline.
Use your Platform API key in Postman or your backend. Keep it private; do not enter it in this public page. Your workspace permissions and plan limits apply.
See the quickstart for request examples. Required fields and responses are listed below.

Authorizations

Authorization
string
header
required

Platform API key for one workspace. Create it in Settings with an expiry date or Never expire. Keep it private; use it from Postman or your backend, not browser code. Widget keys are not accepted.

Headers

Idempotency-Key
string
required

An operation ID, not your API key. Generate a UUID for each new change and reuse it when retrying the same request. See https://docs.layarva.com/developers/platform-request-keys for Postman, PowerShell and Node.js examples. Upload instructions are refreshed when requested again.

Pattern: ^[A-Za-z0-9._:-]{1,128}$

Path Parameters

id
string
required
Pattern: ^[A-Za-z0-9_-]{1,100}$

Body

application/json

Send application/json using the fields below. JSON requests must be no larger than 64 KiB.

The body is of type object.

Response

Safe live-authorized result

data
object
required