curl --request POST \
--url 'https://api-prod.usefini.com/v2/test-sets/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "Refund regression set",
"description": "Refund-policy conversations to re-check before prompt changes.",
"conversationIds": [
"a5221094-72d4-4b9c-8d30-2f785b108bd9",
"2dd2b920-f57c-4e92-8a6a-f310d4c8594d"
]
}'
const response = await fetch('https://api-prod.usefini.com/v2/test-sets/public', {
method: 'POST',
headers: {
Authorization: 'Bearer fini_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Refund regression set',
description: 'Refund-policy conversations to re-check before prompt changes.',
conversationIds: [
'a5221094-72d4-4b9c-8d30-2f785b108bd9',
'2dd2b920-f57c-4e92-8a6a-f310d4c8594d'
]
})
});
const testSet = await response.json();
import requests
response = requests.post(
"https://api-prod.usefini.com/v2/test-sets/public",
headers={
"Authorization": "Bearer fini_your_api_key",
"Content-Type": "application/json",
},
json={
"name": "Refund regression set",
"description": "Refund-policy conversations to re-check before prompt changes.",
"conversationIds": [
"a5221094-72d4-4b9c-8d30-2f785b108bd9",
"2dd2b920-f57c-4e92-8a6a-f310d4c8594d",
],
},
)
test_set = response.json()
{
"id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"status": "success",
"createdAt": "2026-07-28T08:55:32.000Z"
}
Test Sets
Create a test set
Create a Test Suite regression set from existing conversation IDs.
POST
/
v2
/
test-sets
/
public
curl --request POST \
--url 'https://api-prod.usefini.com/v2/test-sets/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "Refund regression set",
"description": "Refund-policy conversations to re-check before prompt changes.",
"conversationIds": [
"a5221094-72d4-4b9c-8d30-2f785b108bd9",
"2dd2b920-f57c-4e92-8a6a-f310d4c8594d"
]
}'
const response = await fetch('https://api-prod.usefini.com/v2/test-sets/public', {
method: 'POST',
headers: {
Authorization: 'Bearer fini_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Refund regression set',
description: 'Refund-policy conversations to re-check before prompt changes.',
conversationIds: [
'a5221094-72d4-4b9c-8d30-2f785b108bd9',
'2dd2b920-f57c-4e92-8a6a-f310d4c8594d'
]
})
});
const testSet = await response.json();
import requests
response = requests.post(
"https://api-prod.usefini.com/v2/test-sets/public",
headers={
"Authorization": "Bearer fini_your_api_key",
"Content-Type": "application/json",
},
json={
"name": "Refund regression set",
"description": "Refund-policy conversations to re-check before prompt changes.",
"conversationIds": [
"a5221094-72d4-4b9c-8d30-2f785b108bd9",
"2dd2b920-f57c-4e92-8a6a-f310d4c8594d",
],
},
)
test_set = response.json()
{
"id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"status": "success",
"createdAt": "2026-07-28T08:55:32.000Z"
}
Creates a test set from existing conversation IDs. Add criteria separately before starting a run.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs write scope.string
required
application/jsonBody parameters
string
required
Non-empty test set name.
string
Optional description.
string[]
required
One to 200 existing conversation IDs. Each value must be a UUID.
Response
Returns the created TestSet object. New test sets return an emptycriteria array until you attach criteria with Add criteria.
curl --request POST \
--url 'https://api-prod.usefini.com/v2/test-sets/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"name": "Refund regression set",
"description": "Refund-policy conversations to re-check before prompt changes.",
"conversationIds": [
"a5221094-72d4-4b9c-8d30-2f785b108bd9",
"2dd2b920-f57c-4e92-8a6a-f310d4c8594d"
]
}'
const response = await fetch('https://api-prod.usefini.com/v2/test-sets/public', {
method: 'POST',
headers: {
Authorization: 'Bearer fini_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Refund regression set',
description: 'Refund-policy conversations to re-check before prompt changes.',
conversationIds: [
'a5221094-72d4-4b9c-8d30-2f785b108bd9',
'2dd2b920-f57c-4e92-8a6a-f310d4c8594d'
]
})
});
const testSet = await response.json();
import requests
response = requests.post(
"https://api-prod.usefini.com/v2/test-sets/public",
headers={
"Authorization": "Bearer fini_your_api_key",
"Content-Type": "application/json",
},
json={
"name": "Refund regression set",
"description": "Refund-policy conversations to re-check before prompt changes.",
"conversationIds": [
"a5221094-72d4-4b9c-8d30-2f785b108bd9",
"2dd2b920-f57c-4e92-8a6a-f310d4c8594d",
],
},
)
test_set = response.json()
{
"id": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
"status": "success",
"createdAt": "2026-07-28T08:55:32.000Z"
}
Was this page helpful?
⌘I