Skip to main content
GET
Get datasets
You are reading the docs of Galtea 5.12. Read this page in the latest version.

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-....

Query Parameters

ids
string[]

Filter by dataset IDs. Answers 404 when a listed ID is not on the returned page.

productIds
string[]

Filter by product IDs. Never matches a dataset with no product, and for a non-admin a product of another organization matches no dataset. Answers 403 when a READER or HUMAN_EVALUATOR names a product outside their grant.

testCaseIds
string[]

Filter by test case IDs

versionIds
string[]

Datasets that a live session (not a seed) inside the caller's read scope ran on one of these versions. With productIds, that session is on a version of those products.

names
string[]

Filter by dataset names (exact match, multiple)

name
string

Filter by dataset name (partial match)

types
enum<string>[]

Filter by dataset types

Available options:
QUALITY,
RED_TEAMING,
SCENARIOS
specificationIds
string[]

Filter by specification IDs. A dataset matches through any of its live links; the filter never widens the read scope.

hasSpecification
boolean

Filter datasets by whether they are linked to a live (not deleted) specification. Omit for no filter.

existentInEvaluations
boolean

true: datasets with a live session (not a seed) inside the caller's read scope (for a non-admin, their organization or the products their user groups grant) that was evaluated successfully. false: datasets with no such session. With versionIds or productIds, that session is on those versions or products.

hasInferenceResults
boolean

true: datasets with a live session (not a seed) inside the caller's read scope (for a non-admin, their organization or the products their user groups grant) that produced inference results (turns). false: datasets with no such session. With versionIds or productIds, that session is on those versions or products.

sort
string[]

Sort instructions (field and direction pairs)

limit
integer
default:10000

Maximum number of results

Required range: 0 <= x <= 9007199254740991
offset
integer
default:0

Number of results to skip

Required range: x >= 0
fromCreatedAt
string<date-time>

Filter datasets created at or after this timestamp (ISO 8601 format)

toCreatedAt
string<date-time>

Filter datasets created at or before this timestamp (ISO 8601 format)

Response

Datasets retrieved successfully

id
string
required
Example:

"test_123"

productId
string | null
required
Example:

"prod_123"

userId
string | null
required
Example:

"user_123"

name
string
required
Example:

"Quality Test"

type
enum<string>
required
Available options:
QUALITY,
RED_TEAMING,
SCENARIOS
Example:

"QUALITY"

models
string[]
required
Example:
groundTruthUri
string | null
required

Storage URI of the ground-truth file, derived from the presigned URL supplied at creation. Returned as <STORAGE_PUBLIC_BASE_URL>/<key> when the deployment configures a public file base, otherwise in its stored form. S3: s3://<bucket>/<key>. Azure Blob: blob URL with the SAS query stripped (e.g. https://<account>.blob.core.windows.net/<container>/<path>). Either form resolves through GET /storage/generate-get-presigned-url.

Example:

"https://files.galtea.ai/tests/test_123/ground-truth.csv"

uri
string | null
required

Storage URI of the uploaded custom test file. Same format rules as groundTruthUri.

Example:

"https://files.galtea.ai/tests/test_123/test.csv"

error
string | null
required
status
enum<string>
required
Available options:
PENDING,
SUCCESS,
FAILED,
AUGMENTING,
EXTENDING,
CANCELLED
Example:

"SUCCESS"

fewShot
string | null
required

Optional few-shot examples (input/output pairs) used to guide test-case generation for QUALITY tests.

Example:

"Example few-shot learning data"

languageCode
string | null
required

BCP-47 language tag (e.g. en, es-MX). The region subtag selects the regional variety in simulated user messages and voice synthesis; generated test text keeps the base language. The value is stored as the full tag. A bare code for ca, de, es, eu, fr, gl, it, nl or pt defaults to the European variety of that language, in simulated user messages only (pt -> pt-PT); an explicit region always overrides it, and neither voice synthesis nor the stored value is affected.

Example:

"es-MX"

backgroundNoiseProfile
enum<string> | null
required

Background noise mixed into the simulated caller audio during a voice test. Clip-backed (office, street, car) or synthetic (white, pink). Null means off; set together with backgroundNoiseLevel.

Available options:
office,
street,
car,
white,
pink,
null
Example:

"street"

backgroundNoiseLevel
enum<string> | null
required

How loud the background noise is relative to the caller speech. Null means off; set together with backgroundNoiseProfile.

Available options:
light,
medium,
heavy,
null
Example:

"medium"

variants
string[]
required

Test variants. QUALITY: rag, entity_extraction, summarization, classification, translation, correction, other. RED_TEAMING: data_leakage, financial_attacks, illegal_activities, misuse, toxicity, custom.

Example:
customVariantDescription
string | null
required
Example:

"Custom variant description"

strategies
string[]
required

Generation strategies. "original" is the default for RED_TEAMING. At least one strategy is required for SCENARIOS tests.

Example:
customUserPersona
string | null
required
Example:

"Business analyst"

maxTestCases
integer | null
required
Example:

100

sourceTestId
string | null
required
dataCatalogUri
string | null
required

Storage URI of the data-catalog file (SCENARIOS tests only). Same format rules as groundTruthUri.

Example:

"https://files.galtea.ai/tests/test_123/data-catalog.json"

metadata
any | null
required

Arbitrary metadata, returned as stored. Usually an object, but any JSON value is accepted.

Example:
specificationIds
string[]
required

The specifications this dataset is linked to, oldest link first.

Example:
specificationId
string | null
required
deprecated

Deprecated, read specificationIds. The oldest linked specification, or null when there is none.

Example:

"spec_123"

isExtendable
boolean
required

True when the test can be extended by re-running its original generator (generated tests; QUALITY only when it has a ground-truth document). False for uploaded tests.

Example:

true

createdAt
string<date-time>
required
deletedAt
string<date-time> | null
required