Deciders

List a decider's versions

Returns the decider's archived question sets, newest first. A version is written on create and on every write that changes questions.

get/v1/projects/{project_id}/deciders/{decider_id}/versions

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/projects/{project_id}/deciders/{decider_id}/versions
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Path parameters

decider_idstring required
Example:dcd_V1StGXR8Z5jdHi6B

The decider ID

Query parameters

limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

offsetinteger

Results to skip. Negative or not an integer it is 400.

Response

List of decider versions, newest first

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "id": "dcd_ver_V1StGXR8Z5jdHi6B",
      "decider_id": "dcd_V1StGXR8Z5jdHi6B",
      "version": 1,
      "config": {
        "questions": [
          {
            "type": "choice",
            "name": "department",
            "instructions": "Which department should handle this complaint?",
            "choices": [
              {
                "value": "billing",
                "description": "Payments, invoices and refunds."
              },
              {
                "value": "technical",
                "description": "Problems using the product."
              }
            ]
          },
          {
            "type": "predicate",
            "name": "needs_human",
            "instructions": "Must a person read this before any automated reply?"
          }
        ]
      },
      "label": "restored from v2",
      "created_by_principal_type": "user",
      "created_by_principal_id": "user_V1StGXR8Z5jdHi6B"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.