Skip to main content
POST
Generate dataset configuration from specifications

Authorizations

Authorization
string
header
required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Body

application/json
specificationIds
string[]
required

IDs of the specifications to generate dataset configs for

Minimum array length: 1
Example:
automaticCreation
boolean

When true, creates the datasets from the generated config and starts their test-case generation on the background worker.

Example:

false

maxTestCases
integer

How many test cases to generate per dataset. Defaults to 3. The upper limit is per test type and deployment-configured, and is enforced when the dataset is created (automaticCreation: true).

Required range: x > 0
Example:

30

groundTruthUri
string<uri>

Presigned upload URL of the knowledge base file, uploaded beforehand. Required for accuracy (QUALITY) specifications, ignored for the other test types.

Response

Dataset configuration generated, and the datasets created when asked for

config
object[]
required

One generated dataset config per specification

tests
object[]

The created datasets, present only when automaticCreation was true. Each comes back PENDING, with its test-case generation running on the background worker.