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

# Run data endpoint

> Execute a data endpoint with your AI Reserve key; the run is billed to your AI Reserve wallet at monid's published price for that endpoint. Sync providers answer inline with the run body and the brokered provider's own HTTP status (200 data, 404 no match, 429 …, all with `status: "COMPLETED"`); async providers answer **202** with `status: "READY"`. Every answer carries an `aireserve` envelope whose `job_id` is what you poll at `GET /v1/monid/runs/{run_id}` — monid's own `runId` is an upstream identifier and is not accepted there.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/monid/run
openapi: 3.0.3
info:
  title: AI Reserve Gateway API
  description: >-
    The AI Reserve API surface — OpenAI-compatible chat completions,
    Anthropic-compatible messages, Bedrock Converse, images, video, files,
    text-to-speech, realtime voice sessions, and GPU Compute pod/volume
    management — all behind one endpoint and one API key.
  version: 1.0.0
servers:
  - url: https://api.aireserve.com
security:
  - bearerAuth: []
paths:
  /v1/monid/run:
    post:
      tags:
        - Data endpoints
      summary: Run data endpoint
      description: >-
        Execute a data endpoint with your AI Reserve key; the run is billed to
        your AI Reserve wallet at monid's published price for that endpoint.
        Sync providers answer inline with the run body and the brokered
        provider's own HTTP status (200 data, 404 no match, 429 …, all with
        `status: "COMPLETED"`); async providers answer **202** with `status:
        "READY"`. Every answer carries an `aireserve` envelope whose `job_id` is
        what you poll at `GET /v1/monid/runs/{run_id}` — monid's own `runId` is
        an upstream identifier and is not accepted there.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - provider
                - endpoint
              properties:
                provider:
                  minLength: 1
                  maxLength: 128
                  pattern: ^[A-Za-z0-9._-]+$
                  type: string
                endpoint:
                  minLength: 1
                  maxLength: 512
                  type: string
                input:
                  type: object
                  additionalProperties: {}
                price:
                  type: object
                  additionalProperties: {}
      responses:
        '200':
          description: Default Response
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your AI Reserve API key (aireserve_api_…) from the API Keys page in the
        portal (https://portal.aireserve.com/keys).

````