API ReferenceFiles
Upload an input file
Uploads a file for later use in CreateRunRequest.files. Agent-specific
media restrictions apply when the file is used, not when it is uploaded.
Authorization
bearerAuth AuthorizationBearer <token>
Send a SimpleServe API key as Authorization: Bearer <key>.
In: header
Header Parameters
Idempotency-Key?string
Prevents duplicate work and charges when a request is retried. Reusing
a key with a different request returns 409 idempotency_conflict.
Length
8 <= length <= 255Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/files" \ -H "Idempotency-Key: 01JXYZ1234567890ABCDEF" \ -F file="string"{ "id": "file_01JXYZ1234567890", "object": "file", "purpose": "agent_input", "filename": "project-brief.pdf", "media_type": "application/pdf", "size_bytes": 284112, "created_at": "2026-08-29T18:20:00Z", "expires_at": null}