curl --request GET \
--url https://api.galtea.ai/specifications \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.galtea.ai/specifications"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.galtea.ai/specifications', 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.galtea.ai/specifications",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.galtea.ai/specifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.galtea.ai/specifications")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.galtea.ai/specifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "spec_123",
"productId": "prod_123",
"userId": "user_123",
"name": "Accurate query responses",
"description": "Product must respond accurately to user queries",
"type": "CAPABILITY",
"testType": "QUALITY",
"testVariant": "rag",
"useForTestAlignment": true,
"isCritical": false,
"metricIds": [
"metric_123"
],
"createdAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
]{
"error": "Error type",
"message": "Error message description"
}Get specifications
Get list of specifications with pagination and filtering. See Specifications.
curl --request GET \
--url https://api.galtea.ai/specifications \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.galtea.ai/specifications"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.galtea.ai/specifications', 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.galtea.ai/specifications",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.galtea.ai/specifications"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.galtea.ai/specifications")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.galtea.ai/specifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"id": "spec_123",
"productId": "prod_123",
"userId": "user_123",
"name": "Accurate query responses",
"description": "Product must respond accurately to user queries",
"type": "CAPABILITY",
"testType": "QUALITY",
"testVariant": "rag",
"useForTestAlignment": true,
"isCritical": false,
"metricIds": [
"metric_123"
],
"createdAt": "2023-11-07T05:31:56Z",
"deletedAt": "2023-11-07T05:31:56Z"
}
]{
"error": "Error type",
"message": "Error message description"
}Authorizations
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
Filter by specification IDs
Filter by organization IDs
Filter by product IDs
Filter by specification types (CAPABILITY, INABILITY, POLICY)
Filter by dataset types
Filter by linked metric IDs
Filter by criticality. true lists only critical specifications, false only the others.
Filter by specification name (partial match)
Filter by specification description (partial match)
Filter by creation date (from)
Filter by creation date (to)
Sort instructions (field and direction pairs)
Maximum number of results
Number of results to skip
Response
Specifications retrieved successfully
"spec_123"
"prod_123"
"user_123"
"Accurate query responses"
"Product must respond accurately to user queries"
CAPABILITY, INABILITY, POLICY "CAPABILITY"
POLICY: the classified value. CAPABILITY: always SCENARIOS (auto-assigned). Null for INABILITY.
QUALITY, RED_TEAMING, SCENARIOS "QUALITY"
Only applicable for POLICY specifications. QUALITY: rag, entity_extraction, summarization, classification, translation, correction, other. RED_TEAMING: data_leakage, financial_attacks, illegal_activities, misuse, toxicity, custom.
"rag"
true
Marks a specification whose failure is serious for the business. Defaults to false. Must not be true for INABILITY specifications.
false
["metric_123"]