Astro AI APIfiles

Reserve a deployment file

View as Markdown

Starts a two-step upload. Reserves an opaque key and returns an upload descriptor; no file bytes are sent in this request. The client must upload the bytes successfully before the key can be listed, downloaded, or attached to a chat message. A relative upload URL is resolved against this collection URL; an absolute URL is a presigned object-store target and is used unchanged.

Authentication

AuthorizationBearer
OAuth 2.0 device flow or platform session token

Path parameters

deploymentIdstringRequired
Deployment ID

Request

This endpoint expects an object.
namestringRequired<=255 characters
Display filename. Must not contain path separators or control characters.
sizelongRequired>=0
Exact declared byte size. Used as the upload ceiling and capacity reservation.
content_typestringOptional

MIME type; defaults to application/octet-stream when empty.

Response

Reserved key and upload target
keystring
fileobject
uploadobject

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
413
Content Too Large Error
500
Internal Server Error
503
Service Unavailable Error
507
Insufficient Storage Error