Connections & Cursor-Based Pagination


Storage Connections

The new /connections resource lets you link S3-compatible storage (Amazon S3, Cloudflare R2, Google Cloud Storage, Supabase Storage) to your project.

  • Ingest files directly from your storage using s3:// URLs
  • Upload task outputs to your own buckets with the upload task kind

Endpoints

GET /connections, POST /connections, GET /connections/:id, PATCH /connections/:id, DELETE /connections/:id


Cursor-Based Pagination

All list endpoints now use cursor-based pagination instead of page-based.

What changed

  • ?page=2?after=<last_id>
  • Links header → Link header (singular, RFC 5988)
  • New Has-More header indicates if more results exist
  • New Limit header shows the applied limit

Parameters

ParameterDescription
afterReturn results after this ID
beforeReturn results before this ID
limitNumber of results (1-100, default: 20)
orderSort order: asc or desc

Conditions Format

Conditions now use an operator-as-key format:

{ "kind": { "eq": "video" }, "width": { "gt": 1920 } }

Operators: eq, not, gt, gte, lt, lte, in, startsWith, endsWith

api
2025-12-15