Sign in
datasets

Upload dataset from JSON, JSONL, CSV, or PyArrow

post/v1/datasets/upload

Query parameters

syncboolean

If true, fulfill request synchronously and return JSON containing dataset_id.

If true, fulfill request synchronously and return JSON containing dataset_id.

Request body

action'create' | 'append' | 'update'
namestring required
descriptionstring
inputsobject[] required
outputsobject[]
metadataobject[]
span_idsstring[]

Span IDs to link examples back to spans

example_idsstring[]

Optional example ID per example. If provided, it is used as the example's stable public ID.

Response

Successful Response

Changes

Changed in 2 of the 70 revisions of this API.538

  • 02361ac1935f8See the full diff
    • ○

      added the new optional request property example_id_key (media type: multipart/form-data)

      new-optional-request-property

    • ○

      added the new optional request property example_ids (media type: application/json)

      new-optional-request-property

    • ○

      added the new optional request property split_key (media type: multipart/form-data)

      new-optional-request-property

    • ○

      added the new update enum value to the request property action (media type: application/json)

      request-property-enum-value-added

    • ○

      added the new update enum value to the request property action (media type: multipart/form-data)

      request-property-enum-value-added

    • ○

      added the required property anyOf[subschema #1: UploadDatasetResponseBody]/data/num_created_examples to the response with the 200 status

      response-required-property-added

    • ○

      added the required property anyOf[subschema #1: UploadDatasetResponseBody]/data/num_deleted_examples to the response with the 200 status

      response-required-property-added

    • ○

      added the required property anyOf[subschema #1: UploadDatasetResponseBody]/data/num_updated_examples to the response with the 200 status

      response-required-property-added

  • c81391216eb553See the full diff
    • ▲

      removed the enum value update of the request property action (media type: application/json)

      request-property-enum-value-removed

    • ▲

      removed the enum value update of the request property action (media type: multipart/form-data)

      request-property-enum-value-removed

    • ▲

      removed the required property anyOf[subschema #1: UploadDatasetResponseBody]/data/num_created_examples from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property anyOf[subschema #1: UploadDatasetResponseBody]/data/num_deleted_examples from the response with the 200 status

      response-required-property-removed

    • ▲

      removed the required property anyOf[subschema #1: UploadDatasetResponseBody]/data/num_updated_examples from the response with the 200 status

      response-required-property-removed

    • ●

      removed the request property example_id_key (media type: multipart/form-data)

      request-property-removed

    • ●

      removed the request property example_ids (media type: application/json)

      request-property-removed

    • ●

      removed the request property split_key (media type: multipart/form-data)

      request-property-removed

    This revision also has 91 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog