Skip to main content
POST
Initiate Upload

Authorizations

Authorization
string
header
required

Aspect API key (sk_...) in Authorization header. 'Bearer ' optional.

Body

application/json

API request schema for initiating an attachment upload

filename
string
required

Original filename

Maximum string length: 255
mime_type
string
required

MIME type of the file

Maximum string length: 127
size_bytes
integer
required

File size in bytes (max 100MB)

Required range: x <= 100000000

Response

Successful Response

Temporary upload URL for a new attachment.

id
string<uuid>
required

Resource identifier

url
string
required

Temporary URL for the upload or download

url_expires_at
string<date-time>
required

UTC datetime when the URL expires