Herald
OpenapiLegal

Revert a realm's agreement to the platform default.

Admin — requires first-party Bearer + `settings.manage` (realm pinned by the session token). Implemented as **default-follow semantics** in the service: a realm-scoped marker version is appended with `source = default` (new `version_id`, monotonic `version_no`), after which effective resolution follows the latest platform default rather than a frozen copy. History remains append-only; no prior rows are deleted. The handler is a thin pass-through.

DELETE
/api/legal/admin/agreements/{agreementType}/custom

Admin — requires first-party Bearer + settings.manage (realm pinned by the session token). Implemented as default-follow semantics in the service: a realm-scoped marker version is appended with source = default (new version_id, monotonic version_no), after which effective resolution follows the latest platform default rather than a frozen copy. History remains append-only; no prior rows are deleted. The handler is a thin pass-through.

Path Parameters

agreementType*string

Agreement type: terms_of_service | privacy_policy

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/api/legal/admin/agreements/string/custom"
{  "effective_at": "2019-08-24T14:15:22Z",  "external_url": "string",  "mode": "full_text",  "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c",  "version_no": 0}
{  "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}
{  "code": "string",  "details": null,  "message": "string",  "requestId": "string",  "status": 0}