Retrieve a legal term
/legal-terms/{legal_term_id}Retrieves a legal term, including its body.
The legal term ID is derived from its scope: trm_platform for the platform term, or trm_product_<n> for a product term, where <n> is the numeric part of the product ID (for example, trm_product_42 for product prd_42).
The response includes an ETag representing the current revision. Send this value in the If-Match header when updating the legal term to avoid overwriting a newer version.
Autonomous mode: the API credential secret, sent as a bearer token. Credential secrets are identified by a fixed prefix.
In: header
Path Parameters
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/legal-terms/string"{ "data": { "acceptances_count": 0, "body": { "blocks": [ {} ] }, "id": "string", "object": "legal_term", "product_id": "string", "revision": "string", "scope": "platform", "title": "string", "updated_at": "2019-08-24T14:15:22Z" }}Create a legal term POST
Configures the legal term for a scope. There is at most one legal term for the platform and one per product, and legal terms are not versioned. The `product` scope requires `product_id`. If the scope already has a legal term, the request is rejected; use the update operation to change its text. Legal terms of replicated accounts and replicated products are read-only.
Update a legal term PATCH
Replaces the body of a legal term. Setting `body` to `null` removes the legal term; subsequent requests for it return `404`. Changing the text does not invalidate acceptances already recorded, and users are not asked to accept the term again. Send the `ETag` returned by the retrieve operation in the `If-Match` header to avoid overwriting a newer version. Legal terms of replicated accounts and replicated products are read-only.