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

# OpenAPI Spec

> The complete OpenAPI 3.1 spec for client generation and agent discovery

<Note>
  Building an agent? Load the entire docs as one file from [`/llms-full.txt`](https://docs.gildea.ai/llms-full.txt) first.
</Note>

The Gildea API publishes a complete **OpenAPI 3.1** specification covering every endpoint, with full request and response schemas, authentication, and parameters.

<Card title="openapi.json" icon="file-code" href="https://docs.gildea.ai/openapi.json">
  View or download the raw machine-readable specification.
</Card>

## What you can do with it

<CardGroup cols={2}>
  <Card title="Generate a client" icon="code">
    Feed the spec to [`openapi-generator`](https://openapi-generator.tech) to scaffold a typed client in any language.
  </Card>

  <Card title="Import into an API client" icon="play">
    Load it into Postman, Insomnia, or Bruno to explore the endpoints interactively.
  </Card>

  <Card title="Power agent discovery" icon="robot">
    Hand the spec to an agent so it can discover endpoints, parameters, and schemas on its own.
  </Card>

  <Card title="Validate requests & responses" icon="circle-check">
    Use the schemas to validate payloads against the contract at build or runtime.
  </Card>
</CardGroup>