Skip to main content
GET
Get linked datasets
You are reading the docs of Galtea 5.15. 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-....

Path Parameters

id
string
required

Specification ID

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