Decisions

Create decisions

Credential

API key

Permission

inference.invoke

Request body

Body up to 8 MiB

curl -X POST "https://api.eu.ccsio.ai/v1/systemone" \
  -H "Authorization: Bearer $CCSIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "clef",
  "state": {
    "ticket": 4312,
    "message": "Production has been down for two hours. This is the third outage this month and we will cancel the contract unless someone calls today."
  },
  "questions": {
    "urgent": {
      "type": "noul",
      "instructions": "Does this ticket need an answer within the hour?"
    },
    "team": {
      "type": "choice",
      "instructions": "Which team should take this ticket?",
      "criteria": {
        "billing": "Invoices, payments and refunds.",
        "technical": "Outages, errors and how the product works.",
        "sales": "Plans, upgrades and contracts."
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated is the customer?",
      "criteria": [
        "Calm.",
        "Annoyed.",
        "Angry.",
        "About to leave."
      ]
    }
  }
}'

Parameters

Request body application/json

Responses

• 200

  One answer per question of the request, and the input tokens the model read.

  Schema

  DecisionResponse

  • modelstringrequired
  • answersobjectrequired

    One answer per question id of the request.

  • usageobjectrequired

    • input_tokensintegerrequired

      at least 0

    • output_tokensintegerrequired

      0 today; it is not metered.

      at least 0

• 400

  The request is refused before it is dispatched, or the model server refused it. invalid-request: a body that is not valid JSON (or not multipart/form-data with a boundary), a member of the wrong type, a missing or empty model, a chat request with no messages, an embeddings or speech request with no input (speech: not a string), an images request with no prompt (not a string), a decisions request with no state, with questions that are not a non-empty object, a message content that is not a string, null or an array, a transcription whose multipart body does not carry exactly one plain model field. session-id-invalid: a malformed or repeated X-Session-Id. provider-bad-request: images and decisions only, the model server refused the request with 400 and the message is its own, bounded and scrubbed of any credential.

  Read more

  The refusals of the hop (a fault of the platform) are listed in x-ccsio-hop-error-codes.

  Error codes:decision-capability-mismatchdecision-stream-mismatchinvalid-requestprovider-bad-requestsession-id-invalid
• 401

  No credential, more than one, or one the platform does not accept: invalid-request (no credential, or both Authorization:

  Read more

  Bearer and x-api-key), api-key-invalid, api-key-unknown, api-key-revoked, api-key-expired, the refusals of a bearer token (token-malformed, token-algorithm-unsupported, token-signature-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, token-claim-invalid), the trust in its issuer (issuer-untrusted, issuer-resolution-unknown, issuer-residency-mismatch, jwks-unavailable, jwks-invalid, jwks-key-not-found), a person with no account on this plane (identity-not-provisioned, organization-not-found) and, for a backoffice operator's token, staff-token-inactive, staff-not-operator and staff-directory-unavailable. The complete list is x-ccsio-boundary-error-codes. A 401 can also be a refusal of the hop between core and the router (missing-verified-context, invalid-verified-context, context-signature-*): that is a fault of the platform, not of the credential. Supply exactly one credential.

• 402

  payment-required: the organization has no active subscription.

  Read more

  The call is refused before its body is read; platform operators are exempt. credits-exhausted: the model is served from a third-party provider, the plane charges such models against prepaid credits, and the organization's balance is zero or negative; the organization tops up (or an operator credits it) and the next request is admitted. Streams already running finish. The model stays listed by GET /v1/models, which never answers credits-exhausted (and answers payment-required like every operation). The error type is invalid_request_error.

  Error codes:credits-exhausted
• 403

  Refused by the platform after the credential was accepted: policy-denied (no role of the caller holds the permission, a personal API key whose owner lacks it, an acting team that is ambiguous or no longer authorized), tenant-mismatch (X-Tenant names another organization), team-not-selectable (X-Team-Id names a team the caller cannot act for), organization-inactive and the other states of the organization (organization-provisioning, organization-suspended, organization-disabled, organization-deleted), user-disabled, organization-selection-required (a person who belongs to several organizations and sent no X-Organization-Id, or a platform operator who selected none), organization-not-selectable, no-active-organization-membership, entitlement-denied (the organization or the acting team is not entitled to the model, which includes a model that does not exist), residency-mismatch (the organization, or the deployment's residency, does not match the plane's) or external-model-not-available (the model is served from a third-party provider and the organization is not admitted to such models: while a payment provider is configured and credits are not enabled only an organization that is billing-exempt or billed by contract is admitted; on a plane where credits are enabled the gate is credits-exhausted or model-not-priced instead, and this refusal is not answered; the model stays listed by GET /v1/models).

  Error codes:entitlement-deniedexternal-model-not-availableorganization-inactiveresidency-mismatch
• 404

  model-not-found: the organization is entitled to the model but no active deployment serves it with the operation's capability. A chat or embeddings model on an audio route, and an audio model on any other route, is refused this way. A path under /v1/ that nothing claims is also a 404, with the code not-found.

  Error codes:model-not-found
• 405

  method-not-allowed: the path is claimed but the request method is not allowed. The Allow header lists the methods the path accepts.

• 413

  request-body-too-large: the request body exceeds the operation's cap (8388608 bytes for a JSON body, 26214400 for an audio transcription upload); answered after authentication and authorization (an unauthenticated or unauthorized request is refused first, without its body being read).

  Error codes:provider-input-too-long
• 429

  A concurrency or rate limit of the organization, the team, the model or the deployment was reached (organization-concurrency-exceeded, team-concurrency-exceeded, model-concurrency-exceeded, deployment-concurrency-exceeded, rate-limit-exceeded; entitlement-denied, which the router answers as a defense in depth when the model is outside the entitlements the hop carries and core has already checked), or the model server rate-limited the call (provider-rate-limited: audio, images, decisions, and chat with a stream; chat without a stream answers that case 503 provider-unavailable).

  Read more

  The router knows when a retry may succeed, but the API host does not relay a Retry-After header: retry with backoff.

  Error codes:deployment-concurrency-exceededentitlement-deniedmodel-concurrency-exceededorganization-concurrency-exceededprovider-rate-limitedrate-limit-exceededteam-concurrency-exceeded
• 500

  A failure of the platform, rendered without internal cause details: internal-error (core could not decide or load what the request needs), quota-store-unavailable (the router could not read its quota store, so the request was refused) and, for a fault of the hop, unsupported-protocol-version, deployment-not-active, tenant-mismatch, model-pin-mismatch, placement-mismatch, bundle-tenant-mismatch and upstream-endpoint-invalid.

  Error codes:internal-errorquota-store-unavailable
• 502

  The model server failed or its answer could not be used: provider-error (it answered an error status other than a 429 that this operation passes on, or nothing usable; its own error body is never relayed), provider-credential-rejected (it answered 401 or 403 to the API key stored for the model's deployment), forwarder-failed (core could not reach the router), internal-hop-body (the router could not read the body core sent). The stored key never appears in any answer.

  Error codes:forwarder-failedprovider-credential-rejectedprovider-error
• 503

  provider-unavailable (OpenAI shape): no deployment of the model is currently healthy, or the one deployment there is failed this very request with a 429, a 5xx or an answer that was not one (on chat without a stream, and on embeddings and non-streaming Responses, where it is rendered in the kernel envelope). model-not-priced (OpenAI shape, type server_error): the model is served from a third-party provider, the plane charges such models against prepaid credits and no price is set for the model in the plane's currency; nothing is dispatched. router-not-configured (the platform kernel envelope, the one deliberate exception of core): this deployment has no inference router at all.

  Error codes:model-not-pricedprovider-unavailablerouter-not-configured
• 504

  provider-timeout: the dispatch deadline passed before the model server answered. Audio, images, decisions and chat; embeddings and Responses never answer 504.

  Error codes:provider-timeout
• 508

  loop-detected: the request carried the X-Ccsio-Egress header, which the platform's own egress adds to every request it makes to a model provider. It is answered when a provider connection points back at the platform's own API; an ordinary client never meets it.

  Error codes:loop-detected

{
  "model": "clef",
  "answers": {
    "urgent": {
      "type": "noul",
      "noul": 0.9542
    },
    "team": {
      "type": "choice",
      "choice": "technical",
      "confidence": 0.927,
      "probabilities": {
        "billing": 0.0175,
        "technical": 0.927,
        "sales": 0.0556
      }
    },
    "frustration": {
      "type": "score",
      "score": 2.8823,
      "confidence": 0.8997,
      "legend": {
        "0": "Calm.",
        "1": "Annoyed.",
        "2": "Angry.",
        "3": "About to leave."
      },
      "probabilities": {
        "0": 0.0035,
        "1": 0.0104,
        "2": 0.0863,
        "3": 0.8997
      }
    }
  },
  "usage": {
    "input_tokens": 382,
    "output_tokens": 0
  }
}