> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moonbounce.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a suggestion

> Returns one suggestion: the proposed structure change with its diff, candidate structure, evidence and status. Another environment's suggestion is 404, like another organization's. On a production key, acceptance is recorded before it is read. `stale` is set when feedback on a case it was evaluated on changed after its evidence was read; its evidence is never rescored, so preview it again.



## OpenAPI

````yaml /openapi.json get /v1/suggestions/{suggestion_id}
openapi: 3.1.0
info:
  title: Moonbounce Decisions API
  version: 0.0.0
  description: >-
    Moonbounce decisions: evaluate an item's state against a decision structure
    (System One questions, attributes you supply and aggregations over both),
    record feedback and seed examples, review a ranked queue, and improve the
    structure through suggestions that ship as code diffs, each with a preview
    (backtest) and an evidence label.


    **Authentication.** Send an API key as `Authorization: Bearer <key>` on
    every operation except `GET /health` and `POST /v1/structures/hash`. Call
    the API from a server, never a browser: a key must not reach one, and the
    API sends no CORS headers. A key belongs to one organization and one
    environment: production, or test for a key with the `env:test` permission.
    Test traffic never counts as production traffic.


    **Requests.** JSON bodies (`Content-Type: application/json`) of at most 1
    MB, parsed strictly: duplicate keys, lone surrogates, integers outside
    ±(2^53 - 1), `__proto__` keys, U+0000 and nesting deeper than 64 are a 400.


    **Retries.** Send an `Idempotency-Key` on every POST under /v1 that takes
    one (all but `POST /v1/structures/hash` and `POST /v1/review/items/fill`,
    whose retry is another fill within the day's budget). Keep it for the
    request's retries. The same key with the same request returns the first
    stored result, marked `Idempotent-Replayed: true`, for 24 hours (410 if that
    result was since deleted); with another request it is 422
    IDEMPOTENCY_KEY_REUSED. Keys are scoped to the organization and environment
    across every operation, so use a fresh key per request. A request that
    failed before its result was stored runs again when retried. 429 and 503
    under /v1 may carry `Retry-After` (seconds); a daily QUOTA_EXCEEDED cap
    instead names its reset time.


    **Errors.** Every error under /v1 is `{"error": {"type", "message",
    "reason"?, "param"?, "details"?}}` (ErrorBody); `GET /health` answers its
    own shape. Every response carries a `Request-Id` header. Rate limits apply
    per key, and per client IP for requests without a valid key; a 429
    RATE_LIMITED carries `Retry-After`.
servers:
  - url: https://api.moonbounce.ai
    description: Production
security: []
paths:
  /v1/suggestions/{suggestion_id}:
    get:
      tags:
        - suggestions
      summary: Get a suggestion
      description: >-
        Returns one suggestion: the proposed structure change with its diff,
        candidate structure, evidence and status. Another environment's
        suggestion is 404, like another organization's. On a production key,
        acceptance is recorded before it is read. `stale` is set when feedback
        on a case it was evaluated on changed after its evidence was read; its
        evidence is never rescored, so preview it again.
      operationId: getSuggestion
      parameters:
        - schema:
            $ref: '#/components/schemas/SugId'
          required: true
          name: suggestion_id
          in: path
      responses:
        '200':
          description: The suggestion
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Suggestion'
        '400':
          description: 'Invalid request: `param` names the field at fault when one applies'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '401':
          description: Missing or invalid API key (reason KEY_INVALID)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '403':
          description: The key may not do this
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '404':
          description: Not found, or not in this key's organization and environment
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '429':
          description: >-
            RATE_LIMITED: retry after Retry-After seconds; QUOTA_EXCEEDED:
            details.reset_at gives the daily reset time (no Retry-After)
          headers:
            Retry-After:
              schema:
                type: string
                description: Seconds to wait before retrying, when waiting helps.
              required: false
              description: Seconds to wait before retrying, when waiting helps.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
        '503':
          description: >-
            Temporarily unavailable, with Retry-After (for example reason
            AUTH_UNAVAILABLE, ENGINE_UNAVAILABLE or STORE_UNAVAILABLE): retry
            with the same Idempotency-Key
          headers:
            Retry-After:
              schema:
                type: string
                description: Seconds to wait before retrying, when waiting helps.
              required: true
              description: Seconds to wait before retrying, when waiting helps.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBody'
      security:
        - bearerAuth:
            - decisions:develop
components:
  schemas:
    SugId:
      type: string
      pattern: >-
        ^sug_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
    Suggestion:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/SugIdOutput'
        decision_id:
          $ref: '#/components/schemas/DecisionIdOutput'
        kind:
          $ref: '#/components/schemas/SuggestionKind'
        target:
          $ref: '#/components/schemas/SuggestionTarget'
        summary:
          type: string
        environment:
          $ref: '#/components/schemas/Environment'
        base:
          $ref: '#/components/schemas/VersionRef'
        candidate:
          $ref: '#/components/schemas/VersionRef'
        requires:
          type: array
          items:
            $ref: '#/components/schemas/SugIdOutput'
        candidate_structure:
          $ref: '#/components/schemas/DecisionStructureOutput'
        diff:
          type: array
          items:
            $ref: '#/components/schemas/StructureDiffEntry'
        evidence:
          $ref: '#/components/schemas/Evidence'
        preview_id:
          $ref: '#/components/schemas/RunId'
        generator:
          $ref: '#/components/schemas/Generator'
        status:
          $ref: '#/components/schemas/SuggestionStatusOutput'
        status_at:
          $ref: '#/components/schemas/Timestamp'
        rejection_reason:
          type: string
        accepted_evaluation_id:
          $ref: '#/components/schemas/EvlIdOutput'
        accepted_at:
          $ref: '#/components/schemas/Timestamp'
        created_at:
          $ref: '#/components/schemas/Timestamp'
        stale:
          type: object
          properties:
            reason:
              type: string
            cases:
              type: integer
              minimum: 1
              description: How many of its evaluated cases have changed feedback.
          required:
            - reason
            - cases
          additionalProperties: true
          description: >-
            Present when feedback on cases this suggestion was evaluated on
            changed after its evidence was read: an answer it read was changed,
            withdrawn or corrected, or the owner, a reviewer or a seed judged
            one of its cases since, or any feedback since marked one's input as
            broken. Its evidence is as it was then; preview it again before
            relying on it.
          x-moonbounce-sdk-known-fields: true
      required:
        - id
        - decision_id
        - kind
        - target
        - summary
        - environment
        - base
        - candidate
        - requires
        - candidate_structure
        - diff
        - evidence
        - preview_id
        - generator
        - status
        - created_at
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    ErrorBody:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              $ref: '#/components/schemas/ErrorType'
            reason:
              type: string
              pattern: ^[A-Z][A-Z0-9_]+$
              description: >-
                Set where a caller can act on it, one of the reasons in the
                ErrorReason schema. New reasons may be added: treat an unknown
                one by the status and `type`.
            message:
              type: string
              description: For people; don't parse it.
            param:
              type: string
              description: >-
                The request field at fault, as a dotted path
                (`attribute_values.region`, `claims.1.value`).
            details:
              type: object
              properties:
                issues:
                  type: array
                  items:
                    $ref: '#/components/schemas/ErrorIssue'
              additionalProperties: {}
          required:
            - type
            - message
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
      required:
        - error
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    SugIdOutput:
      type: string
      pattern: >-
        ^sug_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
    DecisionIdOutput:
      type: string
      pattern: ^[a-z][a-z0-9_.-]{0,127}$
    SuggestionKind:
      type: string
      enum:
        - question_rewrite
        - new_question
      description: >-
        question_rewrite: new wording for one question (its question text and
        criteria). new_question: one new question, added as an input of the
        aggregation that feeds the result's bands or rules.
    SuggestionTarget:
      type: string
      enum:
        - structure
    Environment:
      type: string
      enum:
        - production
        - test
      description: >-
        The environment of the key that made the call: `production` or `test`.
        Evaluations, feedback, reviews and suggestions are separate per
        environment; registered structures are shared.
    VersionRef:
      type: object
      properties:
        structure_hash:
          $ref: '#/components/schemas/StructureHashOutput'
        engine_profile:
          type: string
      required:
        - structure_hash
        - engine_profile
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    DecisionStructureOutput:
      type: object
      properties:
        questions:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/QuestionOutput'
          description: System One questions, keyed by name.
        attributes:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/AttributeOutput'
          description: >-
            Values your app supplies with each call in `attribute_values`. The
            model never sees them.
        aggregations:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/AggregationOutput'
        result:
          type: string
          minLength: 1
          maxLength: 80
          description: The final feature's path, such as `aggregations.band`.
          examples:
            - questions.asks_for_refund
            - aggregations.band
      required:
        - questions
        - result
      additionalProperties: true
      description: >-
        Everything that defines a decision: questions, attribute declarations,
        aggregations and the result. Names are unique across all three maps.
      x-moonbounce-sdk-known-fields: true
    StructureDiffEntry:
      type: object
      properties:
        op:
          type: string
          enum:
            - replace
            - add
            - remove
        path:
          type: string
          pattern: ^\/(questions|aggregations)\/[a-z][a-z0-9_]*(\/[^/]*)*$
        before: {}
        after: {}
      required:
        - op
        - path
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    Evidence:
      type: object
      properties:
        label:
          $ref: '#/components/schemas/EvidenceLabel'
        frozen_at:
          $ref: '#/components/schemas/Timestamp'
        by_split:
          type: object
          properties:
            seed:
              $ref: '#/components/schemas/SplitStats'
            train:
              $ref: '#/components/schemas/SplitStats'
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
        noise_rate:
          type:
            - number
            - 'null'
          minimum: 0
          maximum: 1
        by_source:
          type: object
          properties:
            app_native:
              $ref: '#/components/schemas/SplitStats'
            app_resolution:
              $ref: '#/components/schemas/SplitStats'
            reviewer:
              $ref: '#/components/schemas/SplitStats'
            owner:
              $ref: '#/components/schemas/SplitStats'
            import:
              $ref: '#/components/schemas/SplitStats'
            synthetic_review:
              $ref: '#/components/schemas/SplitStats'
        action_mix:
          anyOf:
            - $ref: '#/components/schemas/ActionMix'
            - type: 'null'
        changed_items:
          type: array
          items:
            $ref: '#/components/schemas/ChangedItem'
        credited_feedback:
          type: array
          items:
            $ref: '#/components/schemas/FbkIdOutput'
      required:
        - label
        - frozen_at
        - by_split
        - noise_rate
        - action_mix
        - changed_items
        - credited_feedback
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    RunId:
      type: string
      pattern: >-
        ^run_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
    Generator:
      type: object
      properties:
        name:
          type: string
          minLength: 1
        version:
          type: string
          minLength: 1
        model:
          type: string
      required:
        - name
        - version
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    SuggestionStatusOutput:
      type: string
      enum:
        - proposed
        - pulled
        - accepted
        - rejected
        - superseded
    Timestamp:
      type: string
      format: date-time
    EvlIdOutput:
      type: string
      pattern: >-
        ^evl_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
    ErrorType:
      type: string
      enum:
        - invalid_request
        - authentication
        - permission_denied
        - not_found
        - conflict
        - rate_limited
        - engine_failed
        - unavailable
        - internal
    ErrorIssue:
      type: object
      properties:
        param:
          type: string
        code:
          type: string
          pattern: ^[A-Z][A-Z0-9_]+$
          description: >-
            Stable, extensible issue code; unknown codes still have a parameter
            and human-readable message.
        message:
          type: string
      required:
        - param
        - code
        - message
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    StructureHashOutput:
      type: string
      pattern: ^sha256:[0-9a-f]{64}$
    QuestionOutput:
      oneOf:
        - $ref: '#/components/schemas/NoulQuestionOutput'
      discriminator:
        propertyName: type
        mapping:
          noul: '#/components/schemas/NoulQuestionOutput'
    AttributeOutput:
      oneOf:
        - $ref: '#/components/schemas/StringAttributeOutput'
        - $ref: '#/components/schemas/NumberAttributeOutput'
        - $ref: '#/components/schemas/BooleanAttributeOutput'
      discriminator:
        propertyName: type
        mapping:
          string: '#/components/schemas/StringAttributeOutput'
          number: '#/components/schemas/NumberAttributeOutput'
          boolean: '#/components/schemas/BooleanAttributeOutput'
    AggregationOutput:
      oneOf:
        - $ref: '#/components/schemas/WeightedMeanOutput'
        - $ref: '#/components/schemas/LogisticOutput'
        - $ref: '#/components/schemas/MinOutput'
        - $ref: '#/components/schemas/MaxOutput'
        - $ref: '#/components/schemas/ProductOutput'
        - $ref: '#/components/schemas/NoisyOrOutput'
        - $ref: '#/components/schemas/AllOutput'
        - $ref: '#/components/schemas/AnyOutput'
        - $ref: '#/components/schemas/BandsOutput'
        - $ref: '#/components/schemas/RulesOutput'
        - $ref: '#/components/schemas/MatchOutput'
      discriminator:
        propertyName: type
        mapping:
          weighted_mean: '#/components/schemas/WeightedMeanOutput'
          logistic: '#/components/schemas/LogisticOutput'
          min: '#/components/schemas/MinOutput'
          max: '#/components/schemas/MaxOutput'
          product: '#/components/schemas/ProductOutput'
          noisy_or: '#/components/schemas/NoisyOrOutput'
          all: '#/components/schemas/AllOutput'
          any: '#/components/schemas/AnyOutput'
          bands: '#/components/schemas/BandsOutput'
          rules: '#/components/schemas/RulesOutput'
          match: '#/components/schemas/MatchOutput'
    EvidenceLabel:
      type: string
      enum:
        - starting_examples
        - training_cases
    SplitStats:
      type: object
      properties:
        'n':
          type: integer
          minimum: 0
        fixes:
          type: integer
          minimum: 0
        breaks:
          type: integer
          minimum: 0
        base_correct:
          type: integer
          minimum: 0
        candidate_correct:
          type: integer
          minimum: 0
      required:
        - 'n'
        - fixes
        - breaks
        - base_correct
        - candidate_correct
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    ActionMix:
      type: object
      properties:
        before:
          type: object
          additionalProperties:
            type: number
            minimum: 0
            maximum: 1
        after:
          type: object
          additionalProperties:
            type: number
            minimum: 0
            maximum: 1
        'on':
          type: string
        'n':
          type: integer
          minimum: 0
      required:
        - before
        - after
        - 'on'
        - 'n'
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    ChangedItem:
      type: object
      properties:
        evaluation_id:
          $ref: '#/components/schemas/EvlIdOutput'
        feedback_id:
          $ref: '#/components/schemas/FbkIdOutput'
        split:
          $ref: '#/components/schemas/Split'
        change:
          type: string
          enum:
            - fix
            - break
        before:
          type: object
          properties:
            outcome:
              $ref: '#/components/schemas/Outcome'
            value:
              type: number
            answers:
              type: object
              additionalProperties:
                type:
                  - number
                  - 'null'
                minimum: 0
                maximum: 1
          required:
            - answers
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
        after:
          type: object
          properties:
            outcome:
              $ref: '#/components/schemas/Outcome'
            value:
              type: number
            answers:
              type: object
              additionalProperties:
                type:
                  - number
                  - 'null'
                minimum: 0
                maximum: 1
          required:
            - answers
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
      required:
        - evaluation_id
        - feedback_id
        - split
        - change
        - before
        - after
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    FbkIdOutput:
      type: string
      pattern: >-
        ^fbk_[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
    NoulQuestionOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - noul
        instructions:
          $ref: '#/components/schemas/InstructionsOutput'
        criteria:
          type: object
          properties:
            'true':
              type: string
              minLength: 1
              maxLength: 4000
            'false':
              type: string
              minLength: 1
              maxLength: 4000
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
        reads:
          type: array
          items:
            $ref: '#/components/schemas/StatePathOutput'
          minItems: 1
          maxItems: 64
          description: >-
            Paths into an object `state` this question reads, such as
            `state.message` or `state.order.customer.tier`. The question sees
            just those values, nested as in the state. Without it the question
            sees the whole state, as in System One. Every path must exist in the
            call's `state`; no entry may repeat or contain another.
      required:
        - type
        - instructions
      additionalProperties: true
      description: P(true) for a statement about the state.
      x-moonbounce-sdk-known-fields: true
    StringAttributeOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - string
        enum:
          type: array
          items:
            type: string
            minLength: 1
            maxLength: 200
          minItems: 1
          maxItems: 255
        default:
          type: string
        source:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            The model and version behind this attribute, such as
            `toxicity-classifier-v3`. Hashed.
      required:
        - type
        - enum
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    NumberAttributeOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - number
        minimum:
          type: number
        maximum:
          type: number
        default:
          type: number
        source:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            The model and version behind this attribute, such as
            `toxicity-classifier-v3`. Hashed.
      required:
        - type
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    BooleanAttributeOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - boolean
        default:
          type: boolean
        source:
          type: string
          minLength: 1
          maxLength: 200
          description: >-
            The model and version behind this attribute, such as
            `toxicity-classifier-v3`. Hashed.
      required:
        - type
      additionalProperties: true
      x-moonbounce-sdk-known-fields: true
    WeightedMeanOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - weighted_mean
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              weight:
                type: number
                exclusiveMinimum: 0
              invert:
                type: boolean
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: 'Σ wᵢ·xᵢ / Σ wᵢ: a weighted average from 0 to 1, not a probability.'
      x-moonbounce-sdk-known-fields: true
    LogisticOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - logistic
        bias:
          type: number
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              weight:
                type: number
            required:
              - name
              - weight
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - bias
        - inputs
      additionalProperties: true
      description: σ(bias + Σ wᵢ·xᵢ), with signed weights on raw input values.
      x-moonbounce-sdk-known-fields: true
    MinOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - min
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              invert:
                type: boolean
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: 'min xᵢ: all of these, when they overlap.'
      x-moonbounce-sdk-known-fields: true
    MaxOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - max
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              invert:
                type: boolean
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: 'max xᵢ: any of these, when they overlap.'
      x-moonbounce-sdk-known-fields: true
    ProductOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - product
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              invert:
                type: boolean
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: 'Π xᵢ: all of these, when they are independent.'
      x-moonbounce-sdk-known-fields: true
    NoisyOrOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - noisy_or
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              invert:
                type: boolean
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: '1 − Π(1 − xᵢ): any of these, when they are independent.'
      x-moonbounce-sdk-known-fields: true
    AllOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - all
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              gte:
                type: number
              gt:
                type: number
              lte:
                type: number
              lt:
                type: number
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: 1 when every input passes its threshold (default ≥ 0.5), else 0.
      x-moonbounce-sdk-known-fields: true
    AnyOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - any
        inputs:
          type: array
          items:
            type: object
            properties:
              name:
                $ref: '#/components/schemas/FeatureRefOutput'
              gte:
                type: number
              gt:
                type: number
              lte:
                type: number
              lt:
                type: number
            required:
              - name
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
      required:
        - type
        - inputs
      additionalProperties: true
      description: 1 when any input passes its threshold (default ≥ 0.5), else 0.
      x-moonbounce-sdk-known-fields: true
    BandsOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - bands
        input:
          $ref: '#/components/schemas/FeatureRefOutput'
        below:
          $ref: '#/components/schemas/NameOutput'
        cuts:
          type: array
          items:
            type: object
            properties:
              at:
                type: number
              outcome:
                $ref: '#/components/schemas/NameOutput'
            required:
              - at
              - outcome
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 9
        abstain:
          $ref: '#/components/schemas/NameOutput'
      required:
        - type
        - input
        - below
        - cuts
      additionalProperties: true
      description: >-
        Names an outcome for each range of one feature's value. `at` means ≥;
        `below` is under the first cut.
      x-moonbounce-sdk-known-fields: true
    RulesOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - rules
        rules:
          type: array
          items:
            type: object
            properties:
              when:
                $ref: '#/components/schemas/ConditionOutput'
              outcome:
                $ref: '#/components/schemas/NameOutput'
            required:
              - when
              - outcome
            additionalProperties: true
            x-moonbounce-sdk-known-fields: true
          minItems: 1
          maxItems: 64
        else:
          $ref: '#/components/schemas/NameOutput'
      required:
        - type
        - rules
        - else
      additionalProperties: true
      description: >-
        The first rule whose condition is true names its `outcome`; otherwise
        `else`.
      x-moonbounce-sdk-known-fields: true
    MatchOutput:
      type: object
      properties:
        type:
          type: string
          enum:
            - match
        input:
          $ref: '#/components/schemas/FeatureRefOutput'
        cases:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/NameOutput'
          description: >-
            Maps labels to outcomes. "__proto__" is not supported as a case key;
            use a rules is-condition for that label.
        else:
          $ref: '#/components/schemas/NameOutput'
        abstain:
          $ref: '#/components/schemas/NameOutput'
      required:
        - type
        - input
        - cases
      additionalProperties: true
      description: Maps a label straight to an outcome.
      x-moonbounce-sdk-known-fields: true
    Split:
      type: string
      enum:
        - seed
        - train
    Outcome:
      type: string
      minLength: 1
      maxLength: 200
      description: >-
        An outcome name, or the exact enum label when a string attribute is the
        result.
    InstructionsOutput:
      anyOf:
        - type: string
          minLength: 1
          maxLength: 4000
        - type: object
          additionalProperties: {}
        - type: array
          items: {}
          minItems: 1
    StatePathOutput:
      type: string
      minLength: 1
      maxLength: 256
      description: >-
        `state.<key>` or a nested object path such as
        `state.order.customer.tier`: keys of an object `state`. A key has no
        `.`, `[` or `]`. Array indexes are not supported yet.
      examples:
        - state.message
        - state.order.order_total_usd
    FeatureRefOutput:
      type: string
      minLength: 1
      maxLength: 80
      description: >-
        A feature's path: `questions.<name>`, `attributes.<name>` or
        `aggregations.<name>`.
      examples:
        - questions.asks_for_refund
        - aggregations.band
    NameOutput:
      type: string
      pattern: ^[a-z][a-z0-9_]{0,63}$
    ConditionOutput:
      anyOf:
        - type: object
          properties:
            name:
              $ref: '#/components/schemas/FeatureRefOutput'
            gte:
              type: number
            gt:
              type: number
            lte:
              type: number
            lt:
              type: number
            is:
              type: string
              minLength: 1
              maxLength: 200
            in:
              type: array
              items:
                type: string
                minLength: 1
                maxLength: 200
              minItems: 1
              maxItems: 255
            abstained:
              type: boolean
              enum:
                - true
          required:
            - name
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
        - type: object
          properties:
            all:
              type: array
              items:
                $ref: '#/components/schemas/ConditionOutput'
              minItems: 1
              maxItems: 64
          required:
            - all
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
        - type: object
          properties:
            any:
              type: array
              items:
                $ref: '#/components/schemas/ConditionOutput'
              minItems: 1
              maxItems: 64
          required:
            - any
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
        - type: object
          properties:
            not:
              $ref: '#/components/schemas/ConditionOutput'
          required:
            - not
          additionalProperties: true
          x-moonbounce-sdk-known-fields: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API key, sent as `Authorization: Bearer <key>`. Each operation lists
        the scope its key needs: `decisions:evaluate` (evaluate and read
        evaluations), `decisions:feedback` (your app's feedback) or
        `decisions:develop` (everything else, including owner feedback and the
        review queue). An operation listing no scope takes any scoped key. A key
        with no scope, or without the operation's, gets 403 INSUFFICIENT_SCOPE.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.