Create upload

Request a presigned URL to upload a file. See Uploads for the full flow and validation rules.

Request

string

required

Bearer sk_live_...

string

required

Original filename, 1–255 characters. The extension determines the content type and must be one of .mp3, .wav, .pdf, .txt, .jpg, .jpeg, .png, .webp.

number

required

File size in bytes (minimum 1). Checked against your plan limit: 25 MB on Free, 100 MB on Pro. The actual size is re-verified when the upload is consumed.

Response

string

Upload id, pass as audioId (audio jobs), imageId (image jobs), or fileId (text jobs).

string

Presigned PUT URL. Valid for 15 minutes.

string

Content type derived from the extension. The PUT request must use exactly this Content-Type header.

number

Upload URL lifetime in seconds (900).

string

ISO timestamp after which the upload can no longer be consumed (24 hours from creation).

Example

curl -s https://api.robinzip.app/v1/upload \
  -H "Authorization: Bearer $ROBIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "episode.mp3", "size": 52428800}'

{
  "success": true,
  "data": {
    "id": "665f1c2ab8d4e91a2c3d4e5f",
    "uploadUrl": "https://...signed-put-url...",
    "contentType": "audio/mpeg",
    "uploadUrlExpiresIn": 900,
    "expiresAt": "2026-07-12T14:00:00.000Z"
  }
}

Then upload the file:

curl -s -X PUT "$UPLOAD_URL" \
  -H "Content-Type: audio/mpeg" \
  --data-binary @episode.mp3

Errors

Code	HTTP	When
`INVALID_FORMAT`	422	Extension not allowed
`FILE_TOO_LARGE`	413	`size` exceeds your plan limit

Getting Started

Core Concepts

API Reference

Create upload

Request

Response

Example

Errors

​Request

​Response

​Example

​Errors

Request

Response

Example

Errors