API reference

Compliance

Data requests, legal document versions, breaches, impact assessments, retention and records of processing.

Scopes for this area: compliance:read, compliance:write and compliance:admin.

78 operations

MethodRouteWhat it doesLevelCommand
GET/compliance/legal/wizardWhat the legal documents still need: jurisdictions (with a recommendation), the questions that are open and what is prefilled.readrivier compliance legal wizard get
MethodRouteWhat it doesLevelCommand
GET/compliance/legal/settingsThe jurisdictions, features, details and languages the legal documents are built from.readrivier compliance legal settings get
PUT/compliance/legal/settingsChoose jurisdictions and fill in the details the documents need. Never publishes anything.writerivier compliance legal settings update
MethodRouteWhat it doesLevelCommand
GET/compliance/legal/statusEvery legal document: what is published, what is open, and which need an update and why.readrivier compliance legal status get
MethodRouteWhat it doesLevelCommand
GET/compliance/legal/documents/{doc}/versionsThe versions of one legal document.readrivier compliance legal version list
POST/compliance/legal/documents/{doc}/versionsDraft a new version of a legal document from the current choices. A draft is never public.writerivier compliance legal version draft
GET/compliance/legal/documents/{doc}/versions/{n}One version with its sections, sources, what is missing and the warnings; HTML and markdown included.readrivier compliance legal version get
GET/compliance/legal/documents/{doc}/diffWhat changed between two versions, section by section.readrivier compliance legal version diff
POST/compliance/legal/documents/{doc}/versions/{n}/reviewPut a draft in review: it shows as waiting for the people who approve it. Changes nothing public.writerivier compliance legal version review
POST/compliance/legal/documents/{doc}/versions/{n}/approveApprove a draft. A person with the approver role, acknowledging that it is a template and not legal advice.writerivier compliance legal version approve
POST/compliance/legal/documents/{doc}/versions/{n}/publishPublish an approved version at its public address with an effective date. A person with the manager role.writerivier compliance legal version publish
GET/compliance/legal/documents/{doc}/versions/{n}/exportA version as HTML, markdown or PDF to download.readrivier compliance legal version export
MethodRouteWhat it doesLevelCommand
PATCH/compliance/legal/documents/{doc}/versions/{n}/sections/{clause}Change the wording of one section of a draft; an edit sends an approved version back to draft.writerivier compliance legal section edit
MethodRouteWhat it doesLevelCommand
POST/compliance/legal/documents/{doc}/withdrawTake a published legal document down.writerivier compliance legal document withdraw
MethodRouteWhat it doesLevelCommand
GET/compliance/legal/consent-textsReady-made consent wording for signup, checkout, newsletter forms and the cookie banner, linked to the published documents.readrivier compliance legal consent texts

checklist

MethodRouteWhat it doesLevelCommand
GET/compliance/center/checklistThe obligations that apply to this project, what Rivier does about each, what is left to the business, the evidence held and the sources. A list of facts, not a score.readrivier compliance checklist get
POST/compliance/center/checklist/confirmRecord that the business has done its part of an obligation (or withdraw that record). A person's statement; Rivier never counts it as its own claim.writerivier compliance checklist confirm

dsar request

MethodRouteWhat it doesLevelCommand
GET/compliance/center/requestsRequests from people about their data, soonest deadline first, with what is overdue or due within a week and the response periods by jurisdiction.readrivier compliance dsar request list
POST/compliance/center/requestsOpen a request on behalf of a person (an email, a phone call): the deadline starts now.writerivier compliance dsar request open
GET/compliance/center/requests/{id}One request: deadline, identity check, what was found where, the plan and the full log.readrivier compliance dsar request get
POST/compliance/center/requests/{id}/identityRecord that the person's identity was checked, and how. A person with the approver role.writerivier compliance dsar request verify
POST/compliance/center/requests/{id}/discoverLook for the person in every connected module. Counts only; modules not connected are named as such.writerivier compliance dsar request discover
POST/compliance/center/requests/{id}/exportRelease the data held about the person, for a person to send to them. Needs a verified identity and the approver role.writerivier compliance dsar request export
POST/compliance/center/requests/{id}/erase/preparePrepare a deletion: which modules would be emptied. Nothing is removed until a person approves.writerivier compliance dsar request prepare erase
POST/compliance/center/requests/{id}/erase/approveApprove and carry out a prepared deletion, by sending the request reference. A person with the manager role; verified identity required.writerivier compliance dsar request approve erase
POST/compliance/center/requests/{id}/extendExtend the deadline once, where the law allows, with the reason (the requester is told).writerivier compliance dsar request extend
POST/compliance/center/requests/{id}/refuseRefuse a request, with the reason.writerivier compliance dsar request refuse
POST/compliance/center/requests/{id}/completeClose a request as done or partly done, with the note sent to the person.writerivier compliance dsar request complete
POST/compliance/center/requests/{id}/withdrawRecord that the person withdrew their request.writerivier compliance dsar request withdraw

ropa

MethodRouteWhat it doesLevelCommand
GET/compliance/center/ropaThe record of processing activities, generated from what the project does plus entries the business added; JSON or markdown.readrivier compliance ropa get

ropa activity

MethodRouteWhat it doesLevelCommand
POST/compliance/center/ropa/activitiesAdd a processing activity the generator cannot see.writerivier compliance ropa activity add
DELETE/compliance/center/ropa/activities/{id}Remove an activity the business added.writerivier compliance ropa activity remove

provider

MethodRouteWhat it doesLevelCommand
GET/compliance/center/providersService providers with the status of the data processing terms. Naming a provider is the business's decision.readrivier compliance provider list
PUT/compliance/center/providers/termsRecord whether the data processing terms are signed with a provider.writerivier compliance provider set terms
GET/compliance/center/providers/dpa-templateA template of data processing terms to send to a provider.readrivier compliance provider dpa template

dpia

MethodRouteWhat it doesLevelCommand
GET/compliance/center/dpiasImpact assessments, the triggers found for this project and the template.readrivier compliance dpia list
POST/compliance/center/dpiasStart an impact assessment, prefilled from a processing activity.writerivier compliance dpia create
PATCH/compliance/center/dpias/{id}Fill in the sections of an impact assessment.writerivier compliance dpia update
POST/compliance/center/dpias/{id}/approveApprove a complete impact assessment. A person with the manager role.writerivier compliance dpia approve

breach

MethodRouteWhat it doesLevelCommand
GET/compliance/center/breachesThe breach register with the notification clocks for each jurisdiction and the checklist.readrivier compliance breach list
POST/compliance/center/breachesLog a breach or a suspected breach; the clock starts at the moment of awareness.writerivier compliance breach log
GET/compliance/center/breaches/{id}One breach entry with its clocks.readrivier compliance breach get
POST/compliance/center/breaches/{id}/assessAssess the risk and the jurisdictions affected. A person.writerivier compliance breach assess
POST/compliance/center/breaches/{id}/notifiedRecord that an authority or the people were told. A person.writerivier compliance breach notified
POST/compliance/center/breaches/{id}/closeClose a breach entry with a note. A person with the manager role.writerivier compliance breach close

retention

MethodRouteWhat it doesLevelCommand
GET/compliance/center/retentionRetention policies, the stores they apply to, recent runs and alerts.readrivier compliance retention get
PUT/compliance/center/retentionSet how long each kind of data is kept. A person with the manager role.writerivier compliance retention set
POST/compliance/center/retention/runRun the retention schedule now: a dry run records what is past its time; applying deletes it and needs a person.writerivier compliance retention run
POST/compliance/center/evidence/retention-runsA job in another module records a retention run it did.writerivier compliance retention evidence
MethodRouteWhat it doesLevelCommand
POST/compliance/center/consent-receiptsThe consent widget records a receipt: versions, region, choices, receipt id; no address. Chained by hash.writerivier compliance consent receipt record
GET/compliance/center/consent-receipts/verifyCheck that the chain of consent receipts is intact.readrivier compliance consent receipt verify
GET/compliance/center/consent-receiptsThe newest consent receipts and how many there are: when, region, banner and rule versions, the choices and the browser's privacy signals. Nothing in a receipt says who the visitor is.readrivier compliance consent receipt list
GET/compliance/center/consent-receipts.csvEvery consent receipt as a CSV file, oldest first, with the hashes that chain them.readrivier compliance consent receipt export

monitor

MethodRouteWhat it doesLevelCommand
GET/compliance/center/monitorWhat changed in the rule packs since the project last acknowledged them, which of it applies, and which documents and analytics settings are affected.readrivier compliance monitor changes
GET/compliance/center/monitor/watchEvery source the obligations rest on with its age and flags, the stale analytics rows and the watch list of pending changes.readrivier compliance monitor watch
POST/compliance/center/monitor/acknowledgeRecord that the changes were read; clears the review flags. A person with the manager role.writerivier compliance monitor acknowledge

analytics rules

MethodRouteWhat it doesLevelCommand
GET/compliance/center/analytics-rulesThe analytics rows: for each region the highest mode, opt-in rule, signals, retention, children policy, fallback mode and review date.readrivier compliance analytics rules get
POST/compliance/center/analytics-rules/decideThe analytics mode for one visitor: region, browser signals, consent and the site's own setting go in; the mode, the reason and whether a prompt is needed come out.readrivier compliance analytics rules decide

readiness

MethodRouteWhat it doesLevelCommand
GET/compliance/center/readinessLegal pages and consent readiness before going live: which required pages are not published, and whether the consent widget, the cookie list and consent receipts are in place (reported as not connected until the widget is). Facts, not certification.readrivier compliance readiness get

overview

MethodRouteWhat it doesLevelCommand
GET/compliance/center/overviewThe overview: open actions, deadlines, documents, requests, rule changes and the standing notice. No score and no badge.readrivier compliance overview get

evidence

MethodRouteWhat it doesLevelCommand
GET/compliance/center/evidence.zipA ZIP for an auditor: checklist, requests, register, records, documents, with a manifest and hashes.readrivier compliance evidence export

profile

MethodRouteWhat it doesLevelCommand
GET/compliance/profileJurisdictions and audience the project is held to.readrivier compliance profile get
PUT/compliance/profileSet jurisdictions and audience.writerivier compliance profile set

check

MethodRouteWhat it doesLevelCommand
POST/compliance/checkCheck text against the rules in force.readrivier compliance check run

report

MethodRouteWhat it doesLevelCommand
GET/compliance/reportWhat is compliant and what is not.readrivier compliance report get

pack

MethodRouteWhat it doesLevelCommand
GET/compliance/packsRule packs.readrivier compliance pack list
POST/compliance/packsAdd a rule pack.writerivier compliance pack create
POST/compliance/packs/syncSync packs from the library.writerivier compliance pack sync
GET/compliance/packs/{id}One rule pack.readrivier compliance pack get
GET/compliance/packs/{id}/versionsA pack's versions.readrivier compliance pack versions
GET/compliance/packs/{id}/diffWhat changed between two versions.readrivier compliance pack diff

control

MethodRouteWhat it doesLevelCommand
GET/compliance/controlsThe controls a pack enforces.readrivier compliance control list

event

MethodRouteWhat it doesLevelCommand
GET/compliance/eventsWhat was checked, blocked or relaxed.readrivier compliance event list

relaxation

MethodRouteWhat it doesLevelCommand
GET/compliance/relaxationsRules a person relaxed, with the reason.readrivier compliance relaxation list
POST/compliance/relaxationsRelax a rule with a recorded reason.writerivier compliance relaxation create
POST/compliance/relaxations/assessWhat relaxing a rule would allow.writerivier compliance relaxation assess
POST/compliance/relaxations/{id}/reactivatePut a relaxed rule back in force.writerivier compliance relaxation reactivate
DELETE/compliance/relaxations/{id}Delete a relaxation.writerivier compliance relaxation delete