Files | OpenDunes Docs

Upload a file once and reference it by id in later requests instead of re-sending the bytes each time. Uploads and storage are free. Full guide: Files.

Endpoint#

HTTP

POST https://opendunes.com/api/v1/files

Authenticate every request with your key: Authorization: Bearer $OPENDUNES_API_KEY.

Example#

Shell

curl https://opendunes.com/api/v1/files \
  -H "Authorization: Bearer $OPENDUNES_API_KEY" \
  -F "file=@photo.png"

Operations#

Method	Path	Description
POST	`/v1/files`	Upload a file (multipart, field `file`).
GET	`/v1/files`	List your files (`limit`, `after` cursor).
GET	`/v1/files/{id}`	Retrieve a file's metadata.
DELETE	`/v1/files/{id}`	Delete a file.
GET	`/v1/files/{id}/content`	Download the raw bytes.

Reference an uploaded file in chat completions with a { "type": "file", "file": { "file_id": "…" } } content part. Limits and supported types are documented in the Files guide.