Create Presigned Upload URL

curl --request POST \ --url https://api.eachlabs.ai/v1/upload/presign \ --header 'Content-Type: application/json' \ --header 'X-API-Key: <api-key>' \ --data ' { "content_type": "image/png", "file_type": "image" } '

{ "id": "0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0", "presigned_url": "https://eachlabs-storage.s3.amazonaws.com/uploads/...?X-Amz-Signature=...", "public_url": "https://cdn-us.eachlabs.ai/uploads/0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0.png", "expires_at": "2026-12-08T18:15:00Z", "required_headers": { "x-amz-meta-file-id": "0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0" } }

Authorizations

X-API-Key

string

header

required

API key for authentication

Body

application/json

content_type

string

required

MIME type of the file to upload

Example:

"image/png"

file_type

enum<string>

High-level file category

Available options:

image,

video,

audio,

other

Example:

"image"

expires_in_seconds

integer

How long the stored file is retained before automatic deletion, in seconds. Sets expires_at in the response. Defaults to 180 days when omitted; clamped to a minimum of 60 seconds and a maximum of 365 days (31536000). Does not affect the 15-minute upload-URL lifetime.

Required range: 60 <= x <= 31536000

Example:

604800

Response

Presigned upload URL created

string

Upload identifier

Example:

"0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0"

presigned_url

string<uri>

Short-lived URL for uploading raw file bytes

Example:

"https://eachlabs-storage.s3.amazonaws.com/uploads/...?X-Amz-Signature=..."

public_url

string<uri>

Public URL to pass as a model input after upload succeeds

Example:

"https://cdn-us.eachlabs.ai/uploads/0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0.png"

expires_at

string<date-time>

When the stored file is automatically deleted (its retention deadline). Defaults to 180 days out; controlled by expires_in_seconds. Not the upload-URL deadline — the presigned URL only accepts uploads for 15 minutes after issuance.

Example:

"2026-12-08T18:15:00Z"

required_headers

object

Headers that must be sent verbatim with the upload PUT request

Show child attributes

Example:

{
  "x-amz-meta-file-id": "0dce0f44-b8a5-4f30-91d4-5f6b0c221bf0"
}