curl --request POST \
--url 'https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
}'
const body = {
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
};
const response = await fetch("https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public", {
method: "POST",
headers: {
Authorization: "Bearer fini_your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify(body),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
import requests
import json
body = json.loads('''
{
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
}
''')
response = requests.request(
"POST",
"https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public",
headers={"Authorization": "Bearer fini_your_api_key"},
json=body,
)
response.raise_for_status()
result = response.json()
{"caseIds": ["00000000-0000-4000-8000-000000000002"]}
Test Suite
Add conversations to criteria group
Capture Inbox conversations and link existing cases in one batch.
POST
/
v2
/
test-suite
/
criteria-groups
/
{id}
/
conversations
/
public
curl --request POST \
--url 'https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
}'
const body = {
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
};
const response = await fetch("https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public", {
method: "POST",
headers: {
Authorization: "Bearer fini_your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify(body),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
import requests
import json
body = json.loads('''
{
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
}
''')
response = requests.request(
"POST",
"https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public",
headers={"Authorization": "Bearer fini_your_api_key"},
json=body,
)
response.raise_for_status()
result = response.json()
{"caseIds": ["00000000-0000-4000-8000-000000000002"]}
Capture Inbox conversations and link existing cases in one batch.
Select between 1 and 50 conversations and cases combined. Captures are validated before the atomic write. With
requestId, retries reuse deterministic case IDs for the same batch. Without it, an existing matching conversation case in the group is reused when available.
Headers
string
required
Bearer token containing your workspace API key. The key needs
write scope.Path parameters
string
required
Criteria-group UUID.
Body parameters
array
required
Unique Inbox conversation UUIDs, up to 50. Send an empty array when adding only existing cases.
array
Unique existing case UUIDs, up to 50.
string
Optional UUID for stable retry deduplication. Reuse it only for the same batch.
Response
Returns the created or linked case UUIDs.curl --request POST \
--url 'https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public' \
--header 'Authorization: Bearer fini_your_api_key' \
--header 'Content-Type: application/json' \
--data '{
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
}'
const body = {
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
};
const response = await fetch("https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public", {
method: "POST",
headers: {
Authorization: "Bearer fini_your_api_key",
"Content-Type": "application/json",
},
body: JSON.stringify(body),
});
if (!response.ok) throw new Error(await response.text());
const result = await response.json();
import requests
import json
body = json.loads('''
{
"conversationIds": [
"00000000-0000-4000-8000-000000000021"
],
"requestId": "00000000-0000-4000-8000-000000000022"
}
''')
response = requests.request(
"POST",
"https://api-prod.usefini.com/v2/test-suite/criteria-groups/00000000-0000-4000-8000-000000000003/conversations/public",
headers={"Authorization": "Bearer fini_your_api_key"},
json=body,
)
response.raise_for_status()
result = response.json()
{"caseIds": ["00000000-0000-4000-8000-000000000002"]}
Was this page helpful?