# AI Catalog

1 operation on the Logion v1 API.

- [AI Catalog document](#ai-catalog-document) — `GET /.well-known/ai-catalog.json`

## AI Catalog document

```http
GET /.well-known/ai-catalog.json
```

Serve the AI Catalog at the well-known URL.

Gated on the ``ai_catalog.public`` feature flag.  Returns the
catalog document with an ETag header for conditional caching.

``offset`` continues a catalog too large for one page.  A page that
has more behind it ends with a nested catalog entry carrying the next
offset, so a consumer walks the whole catalog by following entries
rather than by guessing this parameter.

Operation id: `get_catalog`

**Parameters**

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `offset` | query | integer | no |

**Responses**

| Status | Meaning | Schema |
| --- | --- | --- |
| `200` | AI Catalog document | `AICatalogDocument` |
| `403` | AI Catalog publication is disabled | `ErrorResponse` |
| `422` | Validation Error | `HTTPValidationError` |

Returns `AICatalogDocument`:

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `entries` | CatalogEntry[] | no |  |
| `host` | HostInfo, optional | no |  |
| `metadata` | object | no |  |
| `specVersion` | string | no | default `"1.0"` |