API referenceWorkspace
Accept Workspace Scan Consent
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Body of POST /workspace/scan-consent.
accepted must be true: there is nothing to record about a caller who did
not accept, and a stored row saying otherwise would read as consent on the
trail (the route answers 422 when it is not true). The actor is taken from
the authenticated session, never a body field, for the same reason every
attestation is (#107). terms_version is optional - absent means the version
in force; a stale one is a 422, since the client rendered terms we have since
revised.
Response Body
application/json
application/json
curl -X POST "https://example.com/workspace/scan-consent" \ -H "Content-Type: application/json" \ -d '{ "accepted": true }'{ "consented": true, "terms_version": "string", "current": true}