<!--
  immut documentation, machine-readable.

  Everything in one file:  https://www.immut.io/llms-full.txt
    What immut is, which integration path to choose, authentication and scopes, and the COMPLETE
    API reference: every endpoint with parameters, responses and a runnable curl. Fetch this first
    if you intend to call the API.

  Index of all pages:      https://www.immut.io/llms.txt
  OpenAPI contract:        https://www.immut.io/docs/openapi.json
  This page as HTML:       https://www.immut.io/docs/api/discovery/get-docs

  Any page on this site is available as raw markdown by appending .md to its URL.
-->


# Machine-readable quickstart (no auth)

`GET /docs`

**Auth:** none. This endpoint is keyless.

Unauthenticated JSON covering this whole surface: base URLs, auth, endpoint skeletons, rate limits, verification recipes, and security notes. Agents holding only the API base URL can bootstrap from it.

## Responses

| Status | Meaning |
|---|---|
| `200` | Quickstart JSON |

## Example

```bash
curl -X GET "https://backend.immut.io/api/v1/docs" \
  -H "Authorization: Bearer $IMMUT_API_KEY"
```

## OpenAPI fragment

```json
{
  "/docs": {
    "get": {
      "operationId": "getMachineDocs",
      "summary": "Machine-readable quickstart (no auth)",
      "description": "Unauthenticated JSON covering this whole surface: base URLs, auth, endpoint skeletons, rate limits, verification recipes, and security notes. Agents holding only the API base URL can bootstrap from it.",
      "responses": {
        "200": {
          "description": "Quickstart JSON"
        }
      },
      "tags": [
        "Discovery"
      ]
    }
  }
}
```