---
title: "EstimateRequest"
url: "https://nexora.apim.eu/apis/cost-estimation/versions/26a287d6-a67c-4989-b0bd-79a9db45597a/schemas/EstimateRequest"
---

> Full API specification: https://nexora.apim.eu/apis/cost-estimation/versions/26a287d6-a67c-4989-b0bd-79a9db45597a.md

# EstimateRequest

Exactly one of `agent_id` or `characteristics` must be set.

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Cost & ROI Estimation
  version: 1.0.0
servers:
  - url: https://api.nexora.example/v1
    description: Production
  - url: https://sandbox.api.nexora.example/v1
    description: Sandbox
components:
  schemas:
    EstimateReason:
      type: string
      enum:
        - initial_scoping
        - production_rollout
        - budget_planning
        - renewal
        - decommission
      example: production_rollout
    Characteristics:
      type: object
      description: Freeform agent description, used when no agent deployment record exists.
      required:
        - category
        - business_unit
        - integration_count
      properties:
        category:
          type: string
          enum:
            - copilot
            - autonomous-agent
            - workflow-agent
            - rag-assistant
            - voice-agent
        business_unit:
          type: string
          example: Customer Success
        integration_count:
          type: number
          format: float
          example: 6
        tool_count:
          type: number
          format: float
          example: 4
        expected_monthly_requests:
          type: number
          format: float
          example: 250000
        model_release_date:
          type: string
          format: date
          example: 2026-02-01
        maturity:
          type: string
          enum:
            - pilot
            - stabilizing
            - mature
            - legacy
        deployment_tier:
          type: string
          enum:
            - sandbox
            - pilot
            - production
        has_rag:
          type: boolean
          example: true
        has_tool_use:
          type: boolean
          example: true
        has_human_in_loop:
          type: boolean
          example: false
    EstimateRequest:
      type: object
      required:
        - reason
      description: Exactly one of `agent_id` or `characteristics` must be set.
      properties:
        agent_id:
          type: string
          example: agt_8f2c1a
        reason:
          $ref: "#/components/schemas/EstimateReason"
        characteristics:
          $ref: "#/components/schemas/Characteristics"
```