clarity3

focused-admin1

focused-health1

focused-offboarding2

focused-tools4

focused-webhooks1

Google Connection2

Google OAuth2

oauth-provider22

Priority Guardian Calendar1

Priority Guardian Google Connection2

Priority Guardian Patterns1

Priority Guardian Priorities11

Priority Guardian Snapshots1

Priority Guardian Weekly Report1

priority-guardian-diagnostic2

priority-guardian-health3

priority-guardian-offboarding2

priority-guardian-reconcile1

get/healthHealth Check

clarity

Create Cluster

Upsert the user's cluster snapshot.

Called by Clarity MCP server after successful clustering. Single-row model: INSERT if no snapshot exists, UPDATE if one does.

Headers: X-User-ID: User UUID (required) X-Internal-Secret: Internal API secret (required in production)

Body: cluster_data: {"clusters": [...]} thoughts_exhausted: bool correctly_clustered: bool | null

Returns: 201: {"cluster_id": "...", "created_at": "..."} 400: Invalid cluster_data structure 401: Missing or malformed X-User-ID header 404: User not found

Security: Validates X-Internal-Secret header to ensure request comes from trusted MCP server. In dev mode (INTERNAL_API_SECRET empty), this check is skipped.

post/api/clarity/clusters

Request

Base URL
https://www.priority-guard.com (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/priority-guard/apis/priority-guardian/docs/api/clarity/clusters/post.ts
A function with typed inputs. Its response is checked against the schema.

Headers

X-Internal-Secretstring nullable

X-User-IDstring nullable

Request body

cluster_dataobject required

content_hashstring nullable

thoughts_exhaustedboolean nullable

correctly_clusteredboolean nullable

Response

Successful Response

cluster_idstring uuid required

created_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.