Files API

Conceptual

Uploading inputs and retrieving artifacts.

POST/v1/files— Upload a file (multipart)

GET/v1/files/{id}— Retrieve file metadata

GET/v1/files/{id}/content— Download content

DELETE/v1/files/{id}— Delete a file

GET/v1/runs/{id}/artifacts— List artifacts produced by a run

bash

FILE_ID=$(curl -s https://api.pimsy.ai/v1/files \
  -H "Authorization: Bearer $PIMSY_API_KEY" \
  -F purpose=task_input \
  -F file=@./contracts/2026-q1.pdf | jq -r .id)

curl https://api.pimsy.ai/v1/tasks \
  -H "Authorization: Bearer $PIMSY_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"objective\":\"Extract every fee schedule and flag inconsistencies.\",
       \"attachments\":[{\"type\":\"document\",\"fileId\":\"$FILE_ID\"}]}"

Max upload size: 512 MB per file
Supported purposes: task_input, dataset, reference
Retention: Workspace policy, default 90 days
Encryption: AES-256 at rest, TLS 1.3 in transit

Last updated 2026-09-15