[tooling]: OpenAPI reference validation failures

[github-actions]

Area

area: ci-cd

Failing command or workflow

.github/workflows/openapi-reference-validation.yml

Script or workflow path

tests/integration/openapi-reference-audit.js and .github/workflows/openapi-reference-validation.yml

Full error output

- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/audio-to-text.mdx:2 (POST /audio-to-text)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/hardware-info.mdx:2 (GET /hardware/info)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/hardware-stats.mdx:2 (GET /hardware/stats)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/health.mdx:2 (GET /health)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/image-to-image.mdx:2 (POST /image-to-image)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/image-to-text.mdx:2 (POST /image-to-text)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/image-to-video.mdx:2 (POST /image-to-video)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/live-video-to-video.mdx:2 (POST /live-video-to-video)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/llm.mdx:2 (POST /llm)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/segment-anything-2.mdx:2 (POST /segment-anything-2)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/text-to-image.mdx:2 (POST /text-to-image)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/text-to-speech.mdx:2 (POST /text-to-speech)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-API/upscale.mdx:2 (POST /upscale)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:37 (POST /text-to-image)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:43 (POST /image-to-image)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:49 (POST /image-to-video)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:55 (POST /upscale)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:61 (POST /audio-to-text)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:67 (POST /segment-anything-2)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:73 (POST /llm)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:79 (POST /image-to-text)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:85 (POST /live-video-to-video)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:91 (POST /text-to-speech)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:99 (GET /health)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:105 (GET /hardware/info)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/ai-worker-api.mdx:111 (GET /hardware/stats)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-Worker/ai-worker-api.mdx:37 (POST /text-to-image)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-Worker/ai-worker-api.mdx:43 (POST /image-to-image)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-Worker/ai-worker-api.mdx:49 (POST /image-to-video)
- missing-spec-mapping: v2/gateways-new/resources/api-reference/AI-Worker/ai-worker-api.mdx:55 (POST /upscale)

Reproduction conditions

• Triggered by CI OpenAPI Reference Validation workflow.
• Scope: v2 + locales (v2/es, v2/fr, v2/cn).
• Workflow run: https://github.com/livepeer/docs/actions/runs/22899490584

Expected behavior

All OpenAPI endpoint references should resolve to the canonical mapped spec and pass strict validation.

Action requested from maintainers

Review reported references, apply required content corrections, and re-run the OpenAPI reference audit workflow.

Classification

classification: high

Priority

priority: high

Additional context

• Total failures: 54
• Files analyzed: 1680
• References analyzed: 587

[github-actions]

OpenAPI reference validation is passing again.

Resolved in run: https://github.com/livepeer/docs/actions/runs/22564191387

[github-actions]

OpenAPI reference validation is passing again.

Resolved in run: https://github.com/livepeer/docs/actions/runs/22887907553