celo-org / celo-org/docs

llms.txt: stale OpenAPI spec registration emits a 404 (Mintlify support ticket)

Open
#2,238 0 comments 0 reactions 0 assignees View on GitHub
bug documentation follow-up priority:low size:S
Dominant language
MDX
Stars
90
Forks
382
Avg merge
3d 9h
Merged PRs (30d)
35

Description

Follow-up from #2237.

**This is not fixable from this repo — it needs a Mintlify support ticket.**

## Problem

`https://docs.celo.org/llms.txt` ends with:

```
## OpenAPI Specs

- [openapi](https://docs.celo.org/api-reference/openapi.json)
```

That URL returns **HTTP 404**. The same section appears in `/.well-known/llms.txt`.

Any tool consuming `llms.txt` — an AI assistant indexing the docs, the docs MCP server's consumers — sees a broken link advertised as part of Celo's documentation.

## Why it can't be fixed here

Mintlify documents three sources for this section: top-level `api.openapi` in `docs.json`, `navigation[].openapi`, and page frontmatter (`api:` / `openapi:`). **None of them exist in this repo:**

- No `api` or `openapi` key in `docs.json` (top-level keys: `$schema, theme, name, colors, contextual, background, appearance, banner, fonts, favicon, navigation, navbar, logo, redirects, footer, description`)
- No `api-reference/` directory
- Zero occurrences of the string `openapi` in any `.json`, `.mdx`, `.yml` or `.yaml` file
- No page frontmatter uses `api:` or `openapi:`

`api-reference` happens to be Mintlify's *default output directory* for a configured spec, which points at a stale server-side registration from a spec configured at some point in the past. Mintlify documents no repo-side way to clear it.

The only repo-side workaround is committing a static `llms.txt`, which permanently disables auto-generation for all 264 pages. Not worth it for one bad line.

## Ask

Open a ticket with Mintlify support asking them to clear the stale OpenAPI spec registration for project `celo`, so the `## OpenAPI Specs` section stops being emitted into `llms.txt` and `/.well-known/llms.txt`.

## Verifying the fix

```bash
curl -s https://docs.celo.org/llms.txt | grep -A2 'OpenAPI Specs'
# expect: no output
```

Contributor guide

Open the contributing guide

Research direction

Read the issue and inspect docs.json to confirm that no repo-side api or openapi configuration exists. Open a Mintlify support ticket for project celo requesting removal of the stale registration, then run the provided curl and grep command against both llms.txt outputs. Done means the OpenAPI Specs section is no longer emitted.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.