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

# Evaluate decision

> Evaluates a decision model with the provided context and returns the result. Optionally include trace information for debugging.



## OpenAPI

````yaml /openapi/agent.json post /api/projects/{project}/evaluate/{key}
openapi: 3.1.0
info:
  title: GoRules Agent API
  description: >-
    High-performance rule evaluation service. The Agent loads decision models
    from releases and executes them with minimal latency.
  contact:
    name: GoRules
    email: hi@gorules.io
  version: 1.23.3
servers: []
security:
  - AccessToken: []
tags:
  - name: Evaluation
    description: Evaluate decision models
  - name: Projects
    description: Project information
  - name: System
    description: Health and version endpoints
paths:
  /api/projects/{project}/evaluate/{key}:
    post:
      tags:
        - Evaluation
      summary: Evaluate decision
      description: >-
        Evaluates a decision model with the provided context and returns the
        result. Optionally include trace information for debugging.
      operationId: evaluateDecision
      parameters:
        - name: project
          in: path
          description: Project slug or ID
          required: true
          schema:
            type: string
          example: my-project
        - name: key
          in: path
          description: Decision model key (path)
          required: true
          schema:
            type: string
          example: pricing/calculate-discount
      requestBody:
        description: Evaluation request with context data
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EvaluateRequest'
            example:
              context:
                customer:
                  tier: gold
                  totalOrders: 50
                order:
                  amount: 150
              trace: false
        required: true
      responses:
        '200':
          description: Evaluation result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluateResponse'
        '400':
          description: Invalid request or evaluation error
        '401':
          description: Unauthorized - invalid or missing access token
        '404':
          description: Project or decision model not found
components:
  schemas:
    EvaluateRequest:
      type: object
      description: Request body for decision evaluation
      required:
        - context
      properties:
        context:
          type: object
          description: >-
            Input data for the decision model. The structure depends on your
            decision model's expected input.
          additionalProperties: true
        trace:
          type: boolean
          nullable: true
          description: >-
            When true, includes detailed trace information in the response for
            debugging purposes.
          default: false
    EvaluateResponse:
      type: object
      description: Response from decision evaluation
      properties:
        result:
          type: object
          description: The output from the decision model evaluation
          additionalProperties: true
        trace:
          type: object
          description: >-
            Detailed trace information (only included when trace=true in
            request)
          nullable: true
        details:
          $ref: '#/components/schemas/EvaluateDetailsResponse'
    EvaluateDetailsResponse:
      type: object
      description: Metadata about the evaluation
      properties:
        releaseId:
          type: string
          nullable: true
          description: ID of the release used for evaluation
        versionId:
          type: string
          nullable: true
          description: Version ID of the decision model
  securitySchemes:
    AccessToken:
      type: apiKey
      in: header
      name: X-Access-Token
      description: Evaluation token from project settings

````