Create upload

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

Request

Authorization

string

required

Bearer sk_live_...

filename

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.

size

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).

uploadUrl

string

Presigned PUT URL. Valid for 15 minutes.

contentType

string

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

uploadUrlExpiresIn

number

Upload URL lifetime in seconds (900).

expiresAt

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