file-search

Create Evaluation Upload

Mint a single-use upload URL for an evaluation set. PUT the raw .ndjson bytes to upload_url with exactly the returned headers (no Authorization); the URL accepts one PUT of exactly byte_size bytes, then expires. Files are at most 10,000 lines and 50 MB. The upload is bound to this collection, so a later Create Eval cannot point the same upload_id at a different one. Line format and limits are on the Evaluations guide.

post/v3/collections/{collection_name}/evals/uploads

Path parameters

collection_namestring required

Request body

byte_sizeinteger required

Exact number of bytes the PUT will send. Enforced on PUT.

content_type'application/x-ndjson' | 'application/jsonl' | 'application/octet-stream'

filenamestring required

Must end in .ndjson.

Response

Upload minted. PUT the file to upload_url before expires_at.

byte_sizeinteger required

collection_namestring required

expires_atstring required

filenamestring required

upload_idstring required

upload_urlstring required

Signed, PUT-only, single-use URL on *.captainusercontent.com. Opaque.

Changes

Changed in 2 of the 13 revisions of this API.419

Sep 24, 202661a9364ad042418See the full diff
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ▲
  the response's body type changed from no type to object for status
  response-body-type-changed
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  removed the non-success response with the status
  response-non-success-status-removed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 16, 2026e82391fa5b0b1See the full diff
- ○
  endpoint added
  endpoint-added

Full history