Service Documentation

Mutatio Strategic API

This documentation covers the public discovery surfaces and the worker-powered APIs that support semantic search, knowledge retrieval, health checks, and protected administrative re-indexing.

Machine-readable descriptions are available at /openapi.json and /.well-known/api-catalog.

Canonical Pages

Discovery Endpoints

Public Endpoints

`GET /api/search`

Returns semantically relevant knowledge chunks for compliance automation, MCP integration, workflow orchestration, and training queries.

`GET /api/knowledge`

Returns indexed knowledge entries and supports optional query, product, jurisdiction, topic, and limit filters.

`GET /api/health`

Returns environment, crawl status, indexed chunk counts, and Vectorize metadata.

Authentication

Public endpoints under /api/ are designed for read-oriented discovery and health use cases. Administrative endpoints under /admin/ require an Authorization: Bearer <token> header backed by the Worker secret CRAWL_AUTH_TOKEN.

The site publishes OAuth protected-resource metadata to help agents discover protected surfaces, but it does not yet advertise a full OAuth or OpenID Connect authorization server because the current administrative authentication model is an opaque shared bearer token rather than a standards-based issuer.

Protected Administrative Endpoints

`POST /admin/trigger-crawl`

Protected administrative endpoint for forcing a crawl and re-index.

`POST /admin/content-updated`

Protected administrative endpoint that forces re-indexing after content changes.

Operational Notes

Use the health endpoint before troubleshooting content freshness, and treat the administrative endpoints as operational tools rather than public APIs.

Contact 073 735 2465 for production integration questions.