Sign in

v1

OpenAPI 3.1.02026-07-13632897.9 KB
priority-guardian-reconcile

Reconcile User

Reconcile JWT user_id against openai/subject for cross-device identity continuity.

Called by MCP server after JWT validation, before tool dispatch. Returns the canonical user_id to use for downstream operations.

Cases:

  • A: First-time bind (subject not seen before)
  • B: Match, same user (steady state)
  • C1: Cross-device (fresh shell remapped to canonical)
  • C2: Ambiguous collision (hydrated user, no remap)
  • X: Anomaly (race lost but no owner found; ERROR logged, ops paged)

Requires X-Internal-Secret header. Does NOT accept X-User-ID.

post/api/priority-guardian/reconcile-user

Headers

X-Internal-Secretstring nullable

Request body

jwt_user_idstring uuid required
openai_subjectstring required

Response

Successful Response

user_idstring uuid required
case'A' | 'B' | 'C1' | 'C2' | 'X' required