Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Submit structured decisions

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Submit structured decisions

​

Non-streaming state/questions request; answers retain the Decisions shape.

Headers
  • X-Felo-Channel
    Type: string

    Ordered comma-separated public channel codes. Omit this header to use default; default must be used alone. In wallet mode, default scans the model's effective public channel order in reverse, skips unpublished or unavailable channels, and selects the first available channel's provider. It includes available endpoints from that provider with the same upstream model ID and service tier. Explicit channels are validated in client-specified order; only the first channel's provider group is submitted. No automatic fallback to other providers. Legacy provider headers cannot override channel routing.

Body·DecisionsRequest
required
application/json

Non-streaming Decisions; question definitions pass through unchanged.

  • model
    Type: string
    required
  • questions
    Type: object
    required
    • propertyName
      Type: object
  • state
    required
  • service_tier
    Type: string | null

    Currently only default (standard) is supported. Omitted, null, aliases and unsupported strings fallback to default; other types return HTTP 400. Configured channels and prices remain unchanged. Text APIs send the provider's standard value; Decisions and generation APIs omit the upstream field.

  • stream
    Type: const
    const:  
    false
  • propertyName
    Type: anything
Responses
  • 200
    Type: object · DecisionsResponse

    Decision answers

    • answers
      Type: object
      • propertyName
        Type: anything
    • id
      Type: string
    • usage
      Type: object
      • propertyName
        Type: anything
    • propertyName
      Type: anything
    application/json
  • 400
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
  • 401
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
  • 402
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
  • 403
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
  • 429
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
  • 502
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
  • 503
    Type: object · DecisionsErrorResponse

    Request rejected or upstream unavailable

    • error
      Type: object
      required
      • code
        Type: integer
        required

        Integer numbers.

      • message
        Type: string
        required
    application/json
Request Example for post/api/v1/decisions
curl https://openapi.felo.ai/api/v1/decisions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "model": "configured-decisions-model",
  "state": "A payout failed.",
  "questions": {
    "urgent": {
      "type": "noul",
      "instructions": "Is it urgent?",
      "criteria": {
        "true": "Urgent",
        "false": "No"
      }
    }
  }
}'

{
  "id": "string",
  "answers": {
    "additionalProperty": "anything"
  },
  "usage": {
    "additionalProperty": "anything"
  },
  "additionalProperty": "anything"
}

Decision answers

Submit structured decisions