Add criteria

curl --request POST \
  --url 'https://api-prod.usefini.com/v2/test-sets/44c1f705-8e1a-4f61-8c4c-d519d37fb6b7/criteria/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "criteria": [
      {
        "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
        "blocking": true
      },
      {
        "name": "Used a public reply",
        "type": "deterministic",
        "condition": {
          "scope": "ARRAY",
          "array": {
            "path": "replyTypes",
            "itemType": "string"
          },
          "quantifier": "ANY",
          "predicate": {
            "left": {
              "path": "replyTypes",
              "dataType": "array"
            },
            "operator": "contains",
            "right": {
              "value": "message"
            }
          }
        },
        "blocking": false
      }
    ]
  }'

const testSetId = '44c1f705-8e1a-4f61-8c4c-d519d37fb6b7';

const response = await fetch(`https://api-prod.usefini.com/v2/test-sets/${testSetId}/criteria/public`, {
  method: 'POST',
  headers: {
    Authorization: 'Bearer fini_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    criteria: [
      {
        defaultCriterionId: '96eab02d-3bc3-4b90-ae5b-1a41a1444afa',
        blocking: true
      },
      {
        name: 'Used a public reply',
        type: 'deterministic',
        condition: {
          scope: 'ARRAY',
          array: {
            path: 'replyTypes',
            itemType: 'string'
          },
          quantifier: 'ANY',
          predicate: {
            left: {
              path: 'replyTypes',
              dataType: 'array'
            },
            operator: 'contains',
            right: {
              value: 'message'
            }
          }
        },
        blocking: false
      }
    ]
  })
});

const criteria = await response.json();

import requests

test_set_id = "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7"

response = requests.post(
    f"https://api-prod.usefini.com/v2/test-sets/{test_set_id}/criteria/public",
    headers={
        "Authorization": "Bearer fini_your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "criteria": [
            {
                "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
                "blocking": True,
            },
            {
                "name": "Used a public reply",
                "type": "deterministic",
                "condition": {
                    "scope": "ARRAY",
                    "array": {
                        "path": "replyTypes",
                        "itemType": "string",
                    },
                    "quantifier": "ANY",
                    "predicate": {
                        "left": {
                            "path": "replyTypes",
                            "dataType": "array",
                        },
                        "operator": "contains",
                        "right": {
                            "value": "message",
                        },
                    },
                },
                "blocking": False,
            },
        ],
    },
)

criteria = response.json()

[
  {
    "id": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "companyId": "1d2a4c9f-59f8-4f9c-bd36-6f12e0d5d927",
    "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
    "name": "Goal resolution",
    "type": "complex_judge",
    "judgePrompt": "Judge whether the conversation resolved the user's goal.",
    "passPrompt": "The user's goal was resolved.",
    "failPrompt": "The user's goal was not resolved.",
    "condition": null,
    "blocking": true,
    "isActive": true,
    "createdAt": "2026-07-28T08:56:12.000Z",
    "updatedAt": "2026-07-28T08:56:12.000Z"
  },
  {
    "id": "1e149042-74c6-446a-9da0-e48036909aa9",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "companyId": "1d2a4c9f-59f8-4f9c-bd36-6f12e0d5d927",
    "defaultCriterionId": null,
    "name": "Used a public reply",
    "type": "deterministic",
    "judgePrompt": null,
    "passPrompt": null,
    "failPrompt": null,
    "condition": {
      "scope": "ARRAY",
      "array": {
        "path": "replyTypes",
        "itemType": "string"
      },
      "quantifier": "ANY",
      "predicate": {
        "left": {
          "path": "replyTypes",
          "dataType": "array"
        },
        "operator": "contains",
        "right": {
          "value": "message"
        }
      }
    },
    "blocking": false,
    "isActive": true,
    "createdAt": "2026-07-28T08:56:12.000Z",
    "updatedAt": "2026-07-28T08:56:12.000Z"
  }
]

POST

test-sets

{testSetId}

criteria

public

curl --request POST \
  --url 'https://api-prod.usefini.com/v2/test-sets/44c1f705-8e1a-4f61-8c4c-d519d37fb6b7/criteria/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "criteria": [
      {
        "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
        "blocking": true
      },
      {
        "name": "Used a public reply",
        "type": "deterministic",
        "condition": {
          "scope": "ARRAY",
          "array": {
            "path": "replyTypes",
            "itemType": "string"
          },
          "quantifier": "ANY",
          "predicate": {
            "left": {
              "path": "replyTypes",
              "dataType": "array"
            },
            "operator": "contains",
            "right": {
              "value": "message"
            }
          }
        },
        "blocking": false
      }
    ]
  }'

const testSetId = '44c1f705-8e1a-4f61-8c4c-d519d37fb6b7';

const response = await fetch(`https://api-prod.usefini.com/v2/test-sets/${testSetId}/criteria/public`, {
  method: 'POST',
  headers: {
    Authorization: 'Bearer fini_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    criteria: [
      {
        defaultCriterionId: '96eab02d-3bc3-4b90-ae5b-1a41a1444afa',
        blocking: true
      },
      {
        name: 'Used a public reply',
        type: 'deterministic',
        condition: {
          scope: 'ARRAY',
          array: {
            path: 'replyTypes',
            itemType: 'string'
          },
          quantifier: 'ANY',
          predicate: {
            left: {
              path: 'replyTypes',
              dataType: 'array'
            },
            operator: 'contains',
            right: {
              value: 'message'
            }
          }
        },
        blocking: false
      }
    ]
  })
});

const criteria = await response.json();

import requests

test_set_id = "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7"

response = requests.post(
    f"https://api-prod.usefini.com/v2/test-sets/{test_set_id}/criteria/public",
    headers={
        "Authorization": "Bearer fini_your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "criteria": [
            {
                "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
                "blocking": True,
            },
            {
                "name": "Used a public reply",
                "type": "deterministic",
                "condition": {
                    "scope": "ARRAY",
                    "array": {
                        "path": "replyTypes",
                        "itemType": "string",
                    },
                    "quantifier": "ANY",
                    "predicate": {
                        "left": {
                            "path": "replyTypes",
                            "dataType": "array",
                        },
                        "operator": "contains",
                        "right": {
                            "value": "message",
                        },
                    },
                },
                "blocking": False,
            },
        ],
    },
)

criteria = response.json()

[
  {
    "id": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "companyId": "1d2a4c9f-59f8-4f9c-bd36-6f12e0d5d927",
    "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
    "name": "Goal resolution",
    "type": "complex_judge",
    "judgePrompt": "Judge whether the conversation resolved the user's goal.",
    "passPrompt": "The user's goal was resolved.",
    "failPrompt": "The user's goal was not resolved.",
    "condition": null,
    "blocking": true,
    "isActive": true,
    "createdAt": "2026-07-28T08:56:12.000Z",
    "updatedAt": "2026-07-28T08:56:12.000Z"
  },
  {
    "id": "1e149042-74c6-446a-9da0-e48036909aa9",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "companyId": "1d2a4c9f-59f8-4f9c-bd36-6f12e0d5d927",
    "defaultCriterionId": null,
    "name": "Used a public reply",
    "type": "deterministic",
    "judgePrompt": null,
    "passPrompt": null,
    "failPrompt": null,
    "condition": {
      "scope": "ARRAY",
      "array": {
        "path": "replyTypes",
        "itemType": "string"
      },
      "quantifier": "ANY",
      "predicate": {
        "left": {
          "path": "replyTypes",
          "dataType": "array"
        },
        "operator": "contains",
        "right": {
          "value": "message"
        }
      }
    },
    "blocking": false,
    "isActive": true,
    "createdAt": "2026-07-28T08:56:12.000Z",
    "updatedAt": "2026-07-28T08:56:12.000Z"
  }
]

Adds one or more criteria to a test set. Send either a defaultCriterionId or a full custom criterion definition.

Headers

string

required

Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.

string

required

application/json

Path parameters

string

required

Test set ID.

Body parameters

array

required

One or more criteria to attach to the test set.

string

Default criterion ID from Get fields context. When this is present, do not send custom definition fields; the API copies the default’s definition.

string

Required for custom criteria.

string

Required for custom criteria. Use deterministic, basic_judge, or complex_judge.

string

Required for basic_judge and complex_judge criteria.

string

Required for basic_judge and complex_judge criteria.

string

Required for basic_judge and complex_judge criteria.

object

Required for deterministic criteria. Judge criteria cannot include a condition.

boolean

default:"false"

Whether failing this criterion should fail the conversation overall.

Response

Returns the test set’s updated criteria array.

curl --request POST \
  --url 'https://api-prod.usefini.com/v2/test-sets/44c1f705-8e1a-4f61-8c4c-d519d37fb6b7/criteria/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "criteria": [
      {
        "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
        "blocking": true
      },
      {
        "name": "Used a public reply",
        "type": "deterministic",
        "condition": {
          "scope": "ARRAY",
          "array": {
            "path": "replyTypes",
            "itemType": "string"
          },
          "quantifier": "ANY",
          "predicate": {
            "left": {
              "path": "replyTypes",
              "dataType": "array"
            },
            "operator": "contains",
            "right": {
              "value": "message"
            }
          }
        },
        "blocking": false
      }
    ]
  }'

const testSetId = '44c1f705-8e1a-4f61-8c4c-d519d37fb6b7';

const response = await fetch(`https://api-prod.usefini.com/v2/test-sets/${testSetId}/criteria/public`, {
  method: 'POST',
  headers: {
    Authorization: 'Bearer fini_your_api_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    criteria: [
      {
        defaultCriterionId: '96eab02d-3bc3-4b90-ae5b-1a41a1444afa',
        blocking: true
      },
      {
        name: 'Used a public reply',
        type: 'deterministic',
        condition: {
          scope: 'ARRAY',
          array: {
            path: 'replyTypes',
            itemType: 'string'
          },
          quantifier: 'ANY',
          predicate: {
            left: {
              path: 'replyTypes',
              dataType: 'array'
            },
            operator: 'contains',
            right: {
              value: 'message'
            }
          }
        },
        blocking: false
      }
    ]
  })
});

const criteria = await response.json();

import requests

test_set_id = "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7"

response = requests.post(
    f"https://api-prod.usefini.com/v2/test-sets/{test_set_id}/criteria/public",
    headers={
        "Authorization": "Bearer fini_your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "criteria": [
            {
                "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
                "blocking": True,
            },
            {
                "name": "Used a public reply",
                "type": "deterministic",
                "condition": {
                    "scope": "ARRAY",
                    "array": {
                        "path": "replyTypes",
                        "itemType": "string",
                    },
                    "quantifier": "ANY",
                    "predicate": {
                        "left": {
                            "path": "replyTypes",
                            "dataType": "array",
                        },
                        "operator": "contains",
                        "right": {
                            "value": "message",
                        },
                    },
                },
                "blocking": False,
            },
        ],
    },
)

criteria = response.json()

[
  {
    "id": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "companyId": "1d2a4c9f-59f8-4f9c-bd36-6f12e0d5d927",
    "defaultCriterionId": "96eab02d-3bc3-4b90-ae5b-1a41a1444afa",
    "name": "Goal resolution",
    "type": "complex_judge",
    "judgePrompt": "Judge whether the conversation resolved the user's goal.",
    "passPrompt": "The user's goal was resolved.",
    "failPrompt": "The user's goal was not resolved.",
    "condition": null,
    "blocking": true,
    "isActive": true,
    "createdAt": "2026-07-28T08:56:12.000Z",
    "updatedAt": "2026-07-28T08:56:12.000Z"
  },
  {
    "id": "1e149042-74c6-446a-9da0-e48036909aa9",
    "testSetId": "44c1f705-8e1a-4f61-8c4c-d519d37fb6b7",
    "companyId": "1d2a4c9f-59f8-4f9c-bd36-6f12e0d5d927",
    "defaultCriterionId": null,
    "name": "Used a public reply",
    "type": "deterministic",
    "judgePrompt": null,
    "passPrompt": null,
    "failPrompt": null,
    "condition": {
      "scope": "ARRAY",
      "array": {
        "path": "replyTypes",
        "itemType": "string"
      },
      "quantifier": "ANY",
      "predicate": {
        "left": {
          "path": "replyTypes",
          "dataType": "array"
        },
        "operator": "contains",
        "right": {
          "value": "message"
        }
      }
    },
    "blocking": false,
    "isActive": true,
    "createdAt": "2026-07-28T08:56:12.000Z",
    "updatedAt": "2026-07-28T08:56:12.000Z"
  }
]

⌘I

​Headers

​Path parameters

​Body parameters

​Response

Headers

Path parameters

Body parameters

Response