Skip to main content

Consent / Session schema

See Consent API for the full endpoint reference.

ConsentCreate​

FieldTypeConstraints
scopestr1–255 chars
user_substr1–255 chars
ttl_secondsint | null60–86400

ConsentRead​

FieldTypeNotes
session_idstr
root_grantstrThe hop-1 JWT
policy_versionintPinned for the session's lifetime
scopestr
user_substr
hop_budgetint
expires_atdatetime

SessionRead​

Same as ConsentRead minus root_grant — for reads and diagnostics where no token material should be exposed.