Herald
OpenapiLegal

Reconsent gate verdict for the calling user across both agreement types.

Self-service — requires `inject_identity`. Cross-realm access is rejected with 403 (each user may only inspect their own realm's consent state).

GET
/api/legal/{realmId}/consent/status

Self-service — requires inject_identity. Cross-realm access is rejected with 403 (each user may only inspect their own realm's consent state).

Path Parameters

realmId*string

Realm ID

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/legal/string/consent/status"
{  "items": [    {      "agreement_type": "terms_of_service",      "consented_version_id": "302a62f5-beca-4c6a-922b-c791d5129c54",      "current_version_id": "158beffb-f9de-457f-bbee-873740e72504",      "needs_reconsent": true    }  ]}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}