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

# Agent Forecast

> Profile a CSV, pick a preset automatically, and submit the forecast.



## OpenAPI

````yaml POST /agent/forecast
openapi: 3.1.0
info:
  title: eomer.ai Forecasting API
  description: >-
    Production-grade time series forecasting and natural-language forecasting
    agent
  version: 0.1.0
servers: []
security: []
tags:
  - name: forecasting
    description: Time-series forecasting jobs
  - name: agent
    description: >-
      Natural-language forecasting: extract intent from a prompt, profile and
      recommend a model, and auto-submit a forecast.
  - name: tabular
    description: Classification and regression
  - name: fine-tuning
    description: Custom model training
  - name: storage
    description: Cloud dataset storage
  - name: estimates
    description: Cost and runtime estimation
  - name: system
    description: Health checks and model catalog
paths:
  /agent/forecast:
    post:
      tags:
        - agent
      summary: Submit Agent Forecast
      description: Profile a CSV, pick a preset automatically, and submit the forecast.
      operationId: submit_agent_forecast_agent_forecast_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: >-
                #/components/schemas/Body_submit_agent_forecast_agent_forecast_post
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    Body_submit_agent_forecast_agent_forecast_post:
      properties:
        file:
          anyOf:
            - type: string
              contentMediaType: application/octet-stream
            - type: 'null'
          title: File
        prompt:
          type: string
          title: Prompt
          default: ''
        horizon:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Horizon
        item_id_column:
          type: string
          title: Item Id Column
          default: item_id
        timestamp_column:
          type: string
          title: Timestamp Column
          default: timestamp
        target_column:
          type: string
          title: Target Column
          default: target
        external_covariates:
          type: string
          title: External Covariates
          default: ''
      type: object
      title: Body_submit_agent_forecast_agent_forecast_post
    JobResponse:
      properties:
        job_id:
          type: string
          title: Job Id
        status:
          $ref: '#/components/schemas/JobStatus'
        created_at:
          type: string
          format: date-time
          title: Created At
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
        elapsed_seconds:
          anyOf:
            - type: number
            - type: 'null'
          title: Elapsed Seconds
        num_items:
          anyOf:
            - type: integer
            - type: 'null'
          title: Num Items
        prediction_length:
          anyOf:
            - type: integer
            - type: 'null'
          title: Prediction Length
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
        error_code:
          anyOf:
            - $ref: '#/components/schemas/ErrorCode'
            - type: 'null'
        download_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Download Url
        report_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Report Url
        external_covariate_metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: External Covariate Metadata
        explainability:
          anyOf:
            - $ref: '#/components/schemas/ExplainabilitySummaryResponse'
            - type: 'null'
        explainability_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Explainability Url
        forecast_plot_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Forecast Plot Url
        explanation:
          anyOf:
            - $ref: '#/components/schemas/ExplanationResponse'
            - type: 'null'
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
        config_hash:
          anyOf:
            - type: string
            - type: 'null'
          title: Config Hash
        dataset_hash:
          anyOf:
            - type: string
            - type: 'null'
          title: Dataset Hash
        model_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Model Version
        delivery_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Delivery Status
        delivery_connection_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Delivery Connection Id
        delivery_uri:
          anyOf:
            - type: string
            - type: 'null'
          title: Delivery Uri
        delivery_error:
          anyOf:
            - type: string
            - type: 'null'
          title: Delivery Error
      type: object
      required:
        - job_id
        - status
        - created_at
      title: JobResponse
      description: Response model for job status queries.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    JobStatus:
      type: string
      enum:
        - pending
        - running
        - completed
        - failed
      title: JobStatus
      description: Status values for async forecast jobs.
    ErrorCode:
      type: string
      enum:
        - validation_error
        - invalid_preset
        - file_too_large
        - rate_limited
        - server_overloaded
        - job_not_found
        - job_not_completed
        - auth_failed
        - internal_error
        - timeout
        - pipeline_failed
        - storage_error
        - gpu_offload_unavailable
        - connection_not_found
        - connector_error
        - sandbox_domain_used
        - sandbox_captcha_failed
        - sandbox_dataset_too_large
        - sandbox_corporate_email_required
      title: ErrorCode
      description: Machine-readable error codes for agent-friendly error handling.
    ExplainabilitySummaryResponse:
      properties:
        enabled:
          type: boolean
          title: Enabled
          default: false
        overview_markdown:
          type: string
          title: Overview Markdown
          default: ''
        selected_analyses:
          items:
            type: string
          type: array
          title: Selected Analyses
        completed_analyses:
          items:
            type: string
          type: array
          title: Completed Analyses
        skipped_analyses:
          additionalProperties:
            type: string
          type: object
          title: Skipped Analyses
        warnings:
          items:
            type: string
          type: array
          title: Warnings
        artifacts:
          items:
            $ref: '#/components/schemas/ExplainabilityArtifactResponse'
          type: array
          title: Artifacts
        summary_path:
          anyOf:
            - type: string
            - type: 'null'
          title: Summary Path
      type: object
      title: ExplainabilitySummaryResponse
      description: Explainability execution status for a forecast job.
    ExplanationResponse:
      properties:
        headline:
          type: string
          title: Headline
          default: ''
        narrative:
          type: string
          title: Narrative
          default: ''
        data_findings:
          items:
            type: string
          type: array
          title: Data Findings
        forecast_summary:
          items:
            type: string
          type: array
          title: Forecast Summary
        operational_implications:
          items:
            type: string
          type: array
          title: Operational Implications
        caveats:
          items:
            type: string
          type: array
          title: Caveats
        confidence:
          type: number
          title: Confidence
          default: 0
        generated_by:
          type: string
          title: Generated By
          default: rules
      type: object
      title: ExplanationResponse
      description: >-
        Post-forecast business explanation surfaced on a completed job. Written
        by the explanation agent (the second LLM in the agentic

        "sandwich"). Always vendor-neutral — the backend sanitizes every field

        before persisting, so no underlying model/vendor name appears here.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ExplainabilityArtifactResponse:
      properties:
        artifact_id:
          type: string
          title: Artifact Id
        analysis:
          type: string
          title: Analysis
        label:
          type: string
          title: Label
        format:
          type: string
          title: Format
        output_path:
          anyOf:
            - type: string
            - type: 'null'
          title: Output Path
        download_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Download Url
        embed_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Embed Url
        description:
          type: string
          title: Description
          default: ''
        render_inline:
          type: boolean
          title: Render Inline
          default: false
        preview_markdown:
          type: string
          title: Preview Markdown
          default: ''
        highlights:
          items:
            type: string
          type: array
          title: Highlights
        display_order:
          type: integer
          title: Display Order
          default: 0
        is_primary_visual:
          type: boolean
          title: Is Primary Visual
          default: false
        is_thumbnail:
          type: boolean
          title: Is Thumbnail
          default: false
      type: object
      required:
        - artifact_id
        - analysis
        - label
        - format
      title: ExplainabilityArtifactResponse
      description: A single explainability artifact exposed by the forecast job API.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````