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

# OpenAPI

Use the RogerIQ OpenAPI spec with code generation, API explorers, and HolyDocs.

# OpenAPI

This docs site includes a local OpenAPI spec at:

```txt
./openapi.json
```

The live API exposes the generated spec at:

```txt
https://api.rogeriq.com/api/v1/openapi.json
```

The live endpoint is protected by API-key middleware, so the docs site uses the local spec for rendering and interactive examples.

## Validate the Spec

```bash
npx @holydocs/cli openapi-check docs-site/openapi.json
```

## Generate Reference Pages

```bash
npx @holydocs/cli generate docs-site/openapi.json --dir docs-site --output api-reference
```

## Use with Codegen

```bash
npx openapi-typescript docs-site/openapi.json -o rogeriq-api.d.ts
```

## Server

The OpenAPI spec uses:

```txt
https://api.rogeriq.com
```

Paths include the full `/api/v1` or `/api` prefix so public API and public form endpoints can be described in one spec.