api/docs/README.md

# Phoenix API — API docs

- **GraphQL:** `POST /graphql`. Schema: `GET /graphql/schema`. Interactive: `GET /graphql-playground`.
- **OpenAPI (GraphQL):** [openapi-graphql.yaml](./openapi-graphql.yaml)
- **REST railing (Infra/VE/Health, tenant me):** Same paths as Phoenix Deploy API; when `PHOENIX_RAILING_URL` is set, Sankofa API proxies to it. Full OpenAPI for the railing is in the `phoenix-deploy-api` repo (`openapi.yaml`). Tenant-scoped: `GET /api/v1/tenants/me/resources`, `GET /api/v1/tenants/me/health` (require JWT or X-API-Key with tenant).
API: Phoenix railing proxy, API key auth for /api/v1/, schema export, docs, migrations, tests - Phoenix API Railing: proxy to PHOENIX_RAILING_URL, tenant me routes - Tenant-auth: X-API-Key support for /api/v1/ (api_keys table) - Migration 026: api_keys table; 025 sovereign stack marketplace - GET /graphql/schema, GET /graphql-playground, api/docs OpenAPI - Integration tests: phoenix-railing.test.ts - docs/api/API_VERSIONING: /api/v1/ railing alignment - docs/phoenix/PORTAL_RAILING_WIRING Made-with: Cursor 2026-03-11 12:57:41 -07:00			`# Phoenix API — API docs`

			- GraphQL: `POST /graphql`. Schema: `GET /graphql/schema`. Interactive: `GET /graphql-playground`.
			`- OpenAPI (GraphQL): [openapi-graphql.yaml](./openapi-graphql.yaml)`
			- REST railing (Infra/VE/Health, tenant me): Same paths as Phoenix Deploy API; when `PHOENIX_RAILING_URL` is set, Sankofa API proxies to it. Full OpenAPI for the railing is in the `phoenix-deploy-api` repo (`openapi.yaml`). Tenant-scoped: `GET /api/v1/tenants/me/resources`, `GET /api/v1/tenants/me/health` (require JWT or X-API-Key with tenant).