API ReferenceTestsets

Retrieve a testset

Retrieve a testset by ID.

Authentication

AuthorizationBearer

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

OR
AuthorizationBearer

Use a dashboard JWT only for dashboard-authenticated endpoints. Respan API-key endpoints use the respanApiKey auth field instead.

Path parameters

testset_idstringRequired

The testset ID returned as id by the API.

Response

Testset details.
idstring
Public testset ID.
namestring
Testset name.
created_atdatetime
When the testset was created.
updated_atdatetime
When the testset was last updated.
current_max_row_indexdouble
Highest row index currently present in the testset.
projectstring or nullOptional
Project identifier when the testset is associated with a project.
column_definitionslist of objectsOptional
Configured columns for testset rows.
descriptionstringOptional
Testset description.

Errors

401
Unauthorized Error
404
Not Found Error