Service Documentation
UNIS Design System API
This site exposes a small set of JSON endpoints for the brand assistant, access requests, recruiting workflows, and business-card fulfillment tasks.
Discovery
Machine-readable metadata is published at /openapi.json, /.well-known/api-catalog, /.well-known/oauth-authorization-server, /.well-known/jwks.json, /.well-known/oauth-protected-resource, /.well-known/agent-skills/index.json, and /.well-known/mcp/server-card.json.
Authentication
The site supports two auth modes: interactive email OTP for human access and an OAuth 2.0 client_credentials flow for machine access to protected markdown resources with the guidelines.read scope.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/health | Returns service health metadata for automated monitoring. |
| POST | /api/chat | Runs the site assistant with RAG over the guideline markdown corpus. |
| POST | /api/image | Generates images from prompts for the in-site assistant experience. |
| POST | /api/request-access | Creates a protected-guideline access request for non-allowlisted emails. |
| POST | /api/send-otp | Starts the email one-time-password sign-in flow. |
| POST | /api/verify | Verifies the emailed OTP and returns a session token. |
| POST | /api/oauth/token | Issues OAuth 2.0 bearer tokens for registered machine clients using the client_credentials grant. |
| GET | /api/agent-markdown | Returns markdown representations of supported site pages and accepts OAuth bearer tokens for protected guideline paths. |
| POST | /api/business-card-request | Submits a business card request and triggers confirmation emails. |
| POST | /api/business-cards | Triggers internal and requester notifications for business card workflows. |
| POST | /api/careers | Submits a careers application payload and sends recruiting emails. |