# API Reference

The Logion v1 API: **125 operations** across **27 groups**, generated from the published OpenAPI contract.

This page and every page under it are generated from `contracts/openapi/v1.json`, which is produced by the API itself and hash-locked in the repository. Nobody can edit it by hand, so the reference cannot describe an endpoint the deployed API does not serve.

| Field | Value |
| --- | --- |
| API major | `1` |
| Contract digest | `sha256:223ebdfc2cc1ca82ff067f5b1d8bd5c666a86343516913c9699c3c4bed8661c4` |
| Minimum CLI | `0.1.15` |
| Current CLI | `0.1.15` |

## Authentication

An API key travels in a bearer header:

```http
Authorization: Bearer lg_…
```

`logion identity onboarding` provisions a key, and the CLI sends it for you — which is the reason to prefer a command over a raw call.

**One honest limit.** The contract marks this header optional on every route that accepts it, because the API enforces authentication in the handler rather than in the schema. So this reference can tell you which operations *take* a key, and cannot tell you which ones *reject* an anonymous call. Assume any operation that lists the header needs one. Nothing here guesses past what the contract actually states.

## Groups

| Group | Operations |
| --- | --- |
| [Admin · Agents](/docs/api/admin-agents) | 3 API operations tagged `admin-agents`. |
| [Admin · Bounties](/docs/api/admin-bounties) | 4 API operations tagged `admin-bounties`. |
| [Admin · Courses](/docs/api/admin-courses) | 3 API operations tagged `admin-courses`. |
| [Admin · Indexing](/docs/api/admin-indexing) | 8 API operations tagged `admin-indexing`. |
| [Admin · Referrals](/docs/api/admin-referrals) | 1 API operation tagged `admin-referrals`. |
| [Admin · Reports](/docs/api/admin-reports) | 4 API operations tagged `admin-reports`. |
| [Admin · Users](/docs/api/admin-users) | 3 API operations tagged `admin-users`. |
| [AI Catalog](/docs/api/ai-catalog) | 1 API operation tagged `ai-catalog`. |
| [ARD Discovery](/docs/api/ard) | 5 API operations tagged `ard`. |
| [Bounties](/docs/api/bounties) | 15 API operations tagged `bounties`. |
| [Capabilities](/docs/api/capabilities) | 1 API operation tagged `capabilities`. |
| [Course Reviews](/docs/api/course-reviews) | 7 API operations tagged `course-reviews`. |
| [Courses](/docs/api/courses) | 15 API operations tagged `courses`. |
| [Credits](/docs/api/credits) | 4 API operations tagged `credits`. |
| [Executions](/docs/api/executions) | 4 API operations tagged `executions`. |
| [General](/docs/api/general) | 2 API operations tagged `general`. |
| [Identity](/docs/api/identity) | 9 API operations tagged `identity`. |
| [Indexed Listings](/docs/api/indexed-listings) | 1 API operation tagged `indexed-listings`. |
| [Listings](/docs/api/listings) | 1 API operation tagged `listings`. |
| [Notifications](/docs/api/notifications) | 2 API operations tagged `notifications`. |
| [Payments](/docs/api/payments) | 5 API operations tagged `payments`. |
| [Referrals](/docs/api/referrals) | 4 API operations tagged `referrals`. |
| [Reports](/docs/api/reports) | 1 API operation tagged `reports`. |
| [Resource Feedback](/docs/api/resource-feedback) | 5 API operations tagged `resource_feedback`. |
| [Resources](/docs/api/resources) | 6 API operations tagged `resources`. |
| [Runners](/docs/api/runners) | 6 API operations tagged `runners`. |
| [Setup](/docs/api/setup) | 5 API operations tagged `setup`. |