List test set versions
curl --request GET \
--url https://api.coval.dev/v1/test-sets/{test_set_id}/versions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.coval.dev/v1/test-sets/{test_set_id}/versions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.coval.dev/v1/test-sets/{test_set_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coval.dev/v1/test-sets/{test_set_id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.coval.dev/v1/test-sets/{test_set_id}/versions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.coval.dev/v1/test-sets/{test_set_id}/versions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coval.dev/v1/test-sets/{test_set_id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"versions": [
{
"name": "test-sets/abc12345/versions/01KKWQYSF737ZN6X1Q1RYX8M2D",
"ulid": "01KKWQYSF737ZN6X1Q1RYX8M2D",
"version_number": 2,
"created_by": "<string>",
"label": "v1.2 prod",
"test_set_metadata": {},
"parameters": {},
"test_set_type": "<string>",
"test_cases": [
{}
],
"create_time": "2023-11-07T05:31:56Z"
}
]
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Authentication failed",
"details": [
{
"field": "X-API-Key",
"description": "Invalid or missing API key"
}
]
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Test set not found",
"details": [
{
"field": "test_set_id",
"description": "Test set 'abc12345' not found"
}
]
}
}{
"error": {
"code": "INTERNAL",
"message": "Internal server error",
"details": [
{
"description": "An unexpected error occurred while processing the request"
}
]
}
}Versions
List test set versions
List the prior-state version history for a test set, newest first. The live test set is the current version and is not included here. Each entry captures the test set’s config and an ordered snapshot of its test-case rows.
GET
/
test-sets
/
{test_set_id}
/
versions
List test set versions
curl --request GET \
--url https://api.coval.dev/v1/test-sets/{test_set_id}/versions \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.coval.dev/v1/test-sets/{test_set_id}/versions"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.coval.dev/v1/test-sets/{test_set_id}/versions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coval.dev/v1/test-sets/{test_set_id}/versions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.coval.dev/v1/test-sets/{test_set_id}/versions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.coval.dev/v1/test-sets/{test_set_id}/versions")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coval.dev/v1/test-sets/{test_set_id}/versions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"versions": [
{
"name": "test-sets/abc12345/versions/01KKWQYSF737ZN6X1Q1RYX8M2D",
"ulid": "01KKWQYSF737ZN6X1Q1RYX8M2D",
"version_number": 2,
"created_by": "<string>",
"label": "v1.2 prod",
"test_set_metadata": {},
"parameters": {},
"test_set_type": "<string>",
"test_cases": [
{}
],
"create_time": "2023-11-07T05:31:56Z"
}
]
}{
"error": {
"code": "UNAUTHENTICATED",
"message": "Authentication failed",
"details": [
{
"field": "X-API-Key",
"description": "Invalid or missing API key"
}
]
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Test set not found",
"details": [
{
"field": "test_set_id",
"description": "Test set 'abc12345' not found"
}
]
}
}{
"error": {
"code": "INTERNAL",
"message": "Internal server error",
"details": [
{
"description": "An unexpected error occurred while processing the request"
}
]
}
}Authorizations
Organization API key for authentication
Path Parameters
Test set ID (8-character ID)
Required string length:
8Response
Successful response
Response for GET /v1/test-sets/{test_set_id}/versions (newest first)
Show child attributes
Show child attributes
Was this page helpful?
⌘I