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

# List available models



## OpenAPI

````yaml /identity/reference/api/openapi.yaml get /v1/ai/models
openapi: 3.1.0
info:
  title: kombify Gateway API
  description: >
    Public API reference for the kombify platform, served through the kombify
    public edge at `api.kombify.io`.

    All public traffic is served by the Cloudflare edge worker at
    `api.kombify.io`; the legacy Kong ingress was decommissioned 2026-04-17.


    ## Service Domains


    | Prefix | Service | Description |

    |--------|---------|-------------|

    | `/v1/orchestrator` | Techstack | Core orchestration, projects, users,
    billing |

    | `/v1/simulation` | kombiSim | Infrastructure simulation engine |

    | `/v1/stackkits` | StackKits | IaC/CUE logic service (coming soon) |

    | `/v1/subdomains` | kombify-Me | Subdomain registry & tunnel gateway |

    | `/v1/ai` | kombify-AI-Platform | AI server APIs, provider/model routing,
    sessions, responses, structured output |

    | `/v1/embed` | kombify-AI-Platform | Embed API and Floating Panel iframe
    surface |

    | `/v1/cloud` | kombify-Cloud | Companion and cloud account APIs |

    | `/v1/admin` | kombify-Administration | Protected operator and
    administration APIs |

    | `/v1/connectors` | Gateway Connector Vault | Connector catalog and opaque
    grant metadata |

    | `/v1/harnesses` | Gateway harness policy | Harness settings projection and
    connector bindings |

    | `/v1/ril` | Gateway RIL preflight -> TechStack | RIL server/action policy
    preflight and forwarding |

    | `/v1/agents` | kombify-Agents | Canonical agent runtime API |

    | `/a2a` | kombify-Agents | Agent-to-Agent federation (JSON-RPC) |


    ## Authentication


    Most endpoints require one of:

    - **JWT** (Auth0 OIDC/OAuth): `Authorization: Bearer <token>` — for end
    users

    - **API Key / service credential**: `X-Api-Key: <key>` — for selected
    integrations


    Public endpoints (health, auth-mode, capabilities) require no
    authentication.

    Protected-route denials expose `error_code`, `reason_code`,
    `required_features`,

    `missing_features`, `retryable`, and structured `user_guidance`. This
    contract

    applies to `/v1/agents`, `/v1/ai/models`, `/v1/cloud`, and `/v1/admin`
    before

    the Gateway forwards a request to its origin.


    ## Rate Limits


    | Domain | Requests/min | Requests/hour | Requests/day |

    |--------|-------------|---------------|--------------|

    | Orchestrator | 300 | 5,000 | 50,000 |

    | Orchestrator AI | 60 | 500 | 5,000 |

    | Simulation | 100 | 1,000 | 10,000 |

    | StackKits | 200 | 3,000 | 30,000 |

    | Subdomains | 60 | 500 | 5,000 |

    | AI Platform | 60 | 500 | 5,000 |

    | Agents | 60 | 500 | 5,000 |


    ## Response Headers


    All responses include:

    - `X-Request-ID` — Correlation ID for tracing

    - `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` — Rate
    limit info

    - Standard security headers (HSTS, CSP, X-Frame-Options: DENY)
  version: 2.0.0
  contact:
    name: kombify Team
    url: https://kombify.io
    email: support@kombify.io
  license:
    name: Proprietary
    url: https://kombify.io/terms
servers:
  - url: https://api.kombify.io
    description: Production Gateway
security:
  - bearerAuth: []
  - apiKey: []
tags:
  - name: gateway
    description: Gateway-level health and status
  - name: orchestrator
    description: Core orchestration — projects, users, billing, workers
  - name: simulation
    description: Infrastructure simulation engine (kombiSim)
  - name: simulation-auth
    description: Simulation authentication (public, no gateway auth)
  - name: stackkits
    description: IaC/CUE logic service (not yet deployed)
  - name: subdomains
    description: Subdomain registry & tunnel gateway (kombify-Me)
  - name: ai
    description: >-
      AI Platform service — AI server APIs, models, sessions, responses,
      structured output
  - name: embed
    description: AI Platform embed API and Floating Panel surface
  - name: agents
    description: kombify-Agents runtime API
  - name: agents-a2a
    description: Agent-to-Agent federation protocol
  - name: connectors
    description: Gateway Connector Vault catalog and opaque grant metadata
  - name: harnesses
    description: Gateway harness connector settings and projection surfaces
  - name: ril
    description: Gateway RIL policy preflight before TechStack/StackKits execution
paths:
  /v1/ai/models:
    get:
      tags:
        - ai
      summary: List available models
      operationId: listModels
      responses:
        '200':
          description: Model list
        '401':
          $ref: '#/components/responses/Unauthorized'
        '502':
          $ref: '#/components/responses/GatewayUnavailable'
        '503':
          $ref: '#/components/responses/GatewayUnavailable'
components:
  responses:
    Unauthorized:
      description: Authentication required (JWT or API Key)
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProtectedRouteDenial'
    GatewayUnavailable:
      description: >-
        Gateway authentication, policy, route configuration, or upstream service
        is unavailable; the request failed closed.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ProtectedRouteDenial'
  schemas:
    ProtectedRouteDenial:
      type: object
      description: Stable fail-closed denial returned by protected Gateway routes.
      required:
        - error
        - reason
        - error_code
        - reason_code
        - service
        - required_features
        - missing_features
        - retryable
        - user_guidance
      properties:
        error:
          type: string
          description: Backward-compatible coarse error category.
        reason:
          type: string
          description: Backward-compatible policy or dependency reason.
        error_code:
          type: string
          description: Stable machine-readable error category.
        reason_code:
          type: string
          description: Stable machine-readable reason for this denial.
        capability:
          type: string
          description: Product or API capability that was requested.
        service:
          type: string
          description: Gateway route service identifier.
        required_features:
          type: array
          items:
            type: string
        missing_features:
          type: array
          items:
            type: string
        retryable:
          type: boolean
        user_guidance:
          type: object
          required:
            - title
            - body
            - next_steps
          properties:
            title:
              type: string
            body:
              type: string
            next_steps:
              type: array
              items:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Auth0-issued JWT token for kombify APIs
    apiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: API key from your kombify dashboard

````

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