Decisions

Evaluate System One questions

Evaluate text or structured state against named noul, choice and score questions. Answers use the same question keys. Select a configured decision model with an Aixy API key. Native requests preserve the System One contract; compatible Decisions providers use explicit translation. Provider-specific limits still apply, including rubric size. Unrepresentable extensions fail explicitly. Streaming and output-token caps are unsupported. Hard budgets reject public calls with hard_budget_decision_unbounded. Decision content is processed transiently and is excluded from Activity content capture.

POST

systemone

curl --request POST \
  --url https://api.aixy-gateway.com/v1/systemone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "decision-provider/fastino/GLiDE",
  "state": "Please refund this damaged item.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this request?",
      "criteria": {
        "billing": "Payments and refunds",
        "technical": "Technical problems"
      }
    }
  }
}
'

import requests

url = "https://api.aixy-gateway.com/v1/systemone"

payload = {
    "model": "decision-provider/fastino/GLiDE",
    "state": "Please refund this damaged item.",
    "questions": { "team": {
            "type": "choice",
            "instructions": "Which team should handle this request?",
            "criteria": {
                "billing": "Payments and refunds",
                "technical": "Technical problems"
            }
        } }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'decision-provider/fastino/GLiDE',
    state: 'Please refund this damaged item.',
    questions: {
      team: {
        type: 'choice',
        instructions: 'Which team should handle this request?',
        criteria: {billing: 'Payments and refunds', technical: 'Technical problems'}
      }
    }
  })
};

fetch('https://api.aixy-gateway.com/v1/systemone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "answers": {
    "team": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.9
    }
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "gateway_rate_limit_exceeded",
    "message": "The configured rate limit was reached. Retry later."
  }
}

Internal Server Error

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{}

Authorizations

Authorization

string

header

required

A project-scoped Aixy API key. Create keys in the dashboard and send the secret as a Bearer token.

Headers

X-Request-ID

string

Optional caller-generated request identifier for end-to-end tracing.

Maximum string length: 255

X-Aixy-Client

string

Optional application[/version] for Activity attribution. Overrides User-Agent detection. Use a product name, not personal data or credentials. Names are 1-64 ASCII letters, digits, spaces, dots, underscores or hyphens, starting with a letter or digit. Optional versions start with a digit and use up to 32 letters, digits, dots, underscores, plus signs or hyphens. Invalid values are ignored. This self-declared label grants no permissions and is not forwarded.

Maximum string length: 97

Example:

"Acme Support/1.2.3"

X-Aixy-Session

string

Optional opaque session identifier for virtual routes with session affinity. Scoped to the authenticated caller and alias; never forwarded or recorded. Send full conversation history. Invalid values return 400 when affinity is enabled. Omission retains the route's normal strategy.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9._:-]+$

Example:

"conversation-82"

X-Aixy-Session-ID

string

Optional opaque conversation identifier recorded in Activity metadata. Reuse it for every call in a conversation. Sessions are isolated by organization, project, user and API key. Use no personal data or secrets. Invalid values are ignored. The header is not forwarded, grants no permissions and does not change routing affinity.

Required string length: 1 - 128

Pattern: ^[A-Za-z0-9._:-]+$

Example:

"conversation-82"

X-Provider

string

Select a configured provider without changing an unqualified model identifier. A provider-qualified model is preferred for new integrations.

Body

application/json

model

string

required

Provider-qualified decision model or compatible Aixy routing alias.

Required string length: 1 - 1048576

state

required

questions

object

required

Show child attributes

stream

boolean

default:false

Response

Structured decision answers.

answers

object

required

One answer under each original question key.

Show child attributes

model

string

usage

object

Show child attributes

Evaluate System One questions

curl --request POST \
  --url https://api.aixy-gateway.com/v1/systemone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "decision-provider/fastino/GLiDE",
  "state": "Please refund this damaged item.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should handle this request?",
      "criteria": {
        "billing": "Payments and refunds",
        "technical": "Technical problems"
      }
    }
  }
}
'

import requests

url = "https://api.aixy-gateway.com/v1/systemone"

payload = {
    "model": "decision-provider/fastino/GLiDE",
    "state": "Please refund this damaged item.",
    "questions": { "team": {
            "type": "choice",
            "instructions": "Which team should handle this request?",
            "criteria": {
                "billing": "Payments and refunds",
                "technical": "Technical problems"
            }
        } }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    model: 'decision-provider/fastino/GLiDE',
    state: 'Please refund this damaged item.',
    questions: {
      team: {
        type: 'choice',
        instructions: 'Which team should handle this request?',
        criteria: {billing: 'Payments and refunds', technical: 'Technical problems'}
      }
    }
  })
};

fetch('https://api.aixy-gateway.com/v1/systemone', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "answers": {
    "team": {
      "type": "choice",
      "choice": "billing",
      "confidence": 0.9
    }
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "gateway_rate_limit_exceeded",
    "message": "The configured rate limit was reached. Retry later."
  }
}

Internal Server Error

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{
  "error": {
    "code": "invalid_gateway_api_key",
    "message": "Gateway API key is invalid or revoked"
  }
}

{}

OpenAI

Decisions

Anthropic

Models

Evaluate System One questions

Authorizations

Headers

Body

Response