API ReferenceTestsets

Create testset rows

Create or upsert one or more rows in a testset. Send the rows in the required testset_rows envelope.

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.

Request

This endpoint expects an object.
testset_rowslist of objectsRequired

Response

Rows created or upserted.
row_indexdouble

Row index; decimal values can appear after reordering.

testset_idstring
Parent testset ID.
row_datamap from strings to any

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error