Upload deployment file content | Astro AI

Streams bytes into a previously reserved key. The declared reservation size is a hard ceiling. The file becomes ready and attachable only after this request succeeds.

Authentication

AuthorizationBearer

OAuth 2.0 device flow or platform session token

Path parameters

deploymentIdstringRequired

Deployment ID

fileKeystringRequired

Opaque Files API key returned at reservation time, or an agent-produced filename

Request

This endpoint expects binary data of type application/octet-stream.

Response

Reconciled ready-file metadata

keystring

namestring

sizelong

content_typestring

updated_atdatetime

uploaded_bystring

Opaque owner identity. Omitted when not applicable.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

413

Content Too Large Error

500

Internal Server Error

503

Service Unavailable Error

507

Insufficient Storage Error

$	curl -X PUT https://astropods.com/api/v1/deployments/deploymentId/files/fileKey/content \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/octet-stream" \
>	-d "VGhpcyBpcyBhIHRlc3QgZmlsZSBjb250ZW50Lg=="

1	{
2	"key": "file-9a8b7c6d5e4f3a2b1c0d",
3	"name": "agent-config.yaml",
4	"size": 2048,
5	"content_type": "application/x-yaml",
6	"updated_at": "2024-01-15T09:30:00Z",
7	"uploaded_by": "user-12345"
8	}