> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amdital.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Erase a help-desk requester's personal data (GDPR Art. 17)

> Irreversible. Keyed by the requester email in the POST body. Requires the `helpdesk.settings.manage.workspace` permission; impersonation tokens get 403. Deletes the matching customer rows, strips the address from aliases, cc/bcc and ticket/message authorship; set `redactContent` to also overwrite message bodies. Scoped to the JWT workspace. Rate-limited per user (429).



## OpenAPI

````yaml https://www.amdital.com/openapi.json post /v1/privacy/requesters/erasure
openapi: 3.0.0
info:
  title: AmDital API
  description: >-
    AmDital enterprise business operating system API — generated directly from
    the live NestJS controllers and their Zod request/response schemas (see
    apps/api/src/openapi/generate.ts).
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.amdital.com
    description: Production
  - url: http://localhost:8000
    description: Local development
security:
  - bearerAuth: []
tags:
  - name: Health
    description: Liveness/readiness probe. Unauthenticated.
  - name: AuthNext
    description: >-
      Live authentication surface — login, password verification, token refresh,
      session management, MFA, and admin credential resets.
      login/verify-password/refresh are public (the credential exchange itself);
      session/MFA routes require the bearer JWT they issue; admin/* routes are
      internal-key gated, server-to-server only.
  - name: Content
    description: >-
      Generic tenant-scoped CRUD over the 49 allowlisted content/config
      collections (see the `collection` path parameter enum) — the NestJS
      replacement for Payload REST on these collections; response shapes match
      Payload REST so existing consumers work unchanged.
  - name: Activity
    description: >-
      Activity logs and screenshot capture/scoring for the time-tracking desktop
      agent.
  - name: Ai
    description: AMI agents, prompts, and workflows — create, deploy/activate, and manage.
  - name: Calendar
    description: Workspace calendars and calendar events.
  - name: Clients
    description: Client organizations and client contacts.
  - name: Content Admin
    description: >-
      Public reads for roadmap items, testimonials, feature ideas, and
      blog/survey content; write endpoints (create/update/remove, upvote, survey
      responses) require the `x-internal-key`/`x-api-key` server-to-server
      header — these writes are not for third-party API consumers.
  - name: Crm
    description: >-
      Companies, leads, deals, pipelines, products, sequences, sequence
      enrollments, custom field definitions, lead routing rules, and client
      portal tokens. Contacts are documented separately under the Clients tag.
  - name: Docs
    description: >-
      Tenant-internal wiki: doc categories and doc pages (distinct from the
      public docs-site content under Public Content).
  - name: Finance
    description: Invoices, payments, budgets, expenses, and purchase orders.
  - name: Goals
    description: Workspace goals/OKRs.
  - name: Hrms
    description: >-
      Employees, departments, roles, shifts, leave requests, performance
      reviews, payroll runs, compliance records, salary structures/revisions,
      bonuses, arrears, and the per-employee payroll activity feed.
  - name: Integrations
    description: Outbound webhooks and third-party integration tokens.
  - name: Lms
    description: >-
      Learning management: the paginated course list, enrollment/module/lesson
      CRUD, lesson completion, course favorites, and course-category CRUD.
  - name: Marketing
    description: Marketing campaigns, email templates, and marketing assets.
  - name: Public Content
    description: >-
      Fully public, unauthenticated docs/marketing content reads (doc
      categories, doc articles, changelog, FAQs) — paths intentionally match
      Payload REST exactly (no `/v1`, no auth) because apps/docs hardcodes these
      URLs.
  - name: Recruitment
    description: Job postings, applicants, and interviews.
  - name: Reports
    description: Saved report configurations/definitions.
  - name: Report Definitions
    description: >-
      Reusable saved report definitions (name/type/filter-definition/schedule)
      distinct from the one-off generated reports above — includes "run" to
      execute a definition and produce a new report_snapshots row.
  - name: Support
    description: Support channels and tickets, including ticket assignment.
  - name: Time
    description: Time entries/timers and timesheets, including submit/approve/reject.
  - name: Approvals
    description: >-
      Approval requests — read and decide only, by design (no
      create/update/delete).
  - name: Work
    description: Projects, tasks, sprints, chat channels/messages, and work files.
  - name: Notifications
    description: >-
      The signed-in user's in-app notification inbox for the current workspace
      (read-only).
  - name: Workspaces
    description: >-
      Workspaces the signed-in user belongs to (self-service, not scoped to one
      workspace).
  - name: Mcp
    description: >-
      Model Context Protocol server (stateless Streamable HTTP) — the JSON-RPC
      2.0 endpoint (POST, authenticated by a workspace API key or auth-next
      JWT), a public human-readable descriptor at `/info` (GET), and
      spec-mandated 405s for GET/DELETE at the bare endpoint (no SSE stream, no
      sessions).
  - name: Mcp OAuth
    description: >-
      Consent screen backing (read/decide a pending MCP OAuth authorization) and
      the workspace's connected-AI-tool grants (list/revoke). Bearer JWT
      required.
  - name: Metrics
    description: >-
      Prometheus text-format scrape endpoint, authenticated by its own static
      scrape token (not a user JWT).
  - name: Privacy
    description: >-
      GDPR self-service for the signed-in user (export of their personal data,
      irreversible account erasure) and workspace-admin export/erasure of an
      external help-desk requester by email. Bearer JWT required; impersonation
      tokens are refused.
  - name: Internal
    description: >-
      Server-to-server endpoints for AmDital's own apps (trusted Origin + proxy
      secret). Not for third-party API consumers.
paths:
  /v1/privacy/requesters/erasure:
    post:
      tags:
        - Privacy
      summary: Erase a help-desk requester's personal data (GDPR Art. 17)
      description: >-
        Irreversible. Keyed by the requester email in the POST body. Requires
        the `helpdesk.settings.manage.workspace` permission; impersonation
        tokens get 403. Deletes the matching customer rows, strips the address
        from aliases, cc/bcc and ticket/message authorship; set `redactContent`
        to also overwrite message bodies. Scoped to the JWT workspace.
        Rate-limited per user (429).
      operationId: RequesterPrivacyController_eraseRequester
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrivacyRequesterErasureBody'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PrivacyRequesterErasureResponse'
components:
  schemas:
    PrivacyRequesterErasureBody:
      type: object
      properties:
        email:
          type: string
          maxLength: 320
          format: email
        redactContent:
          type: boolean
      required:
        - email
      additionalProperties: false
    PrivacyRequesterErasureResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - completed
            - completed_with_unresolved
        contentRedacted:
          type: boolean
        cluster:
          type: object
          properties:
            customers:
              type: integer
            addresses:
              type: integer
          required:
            - customers
            - addresses
        unresolvedAttachmentIds:
          type: array
          items:
            type: string
        counts:
          type: object
          properties:
            customersDeleted:
              type: integer
            customerAliasesRemoved:
              type: integer
            ticketsRequesterScrubbed:
              type: integer
            ticketsCcBccStripped:
              type: integer
            messagesAuthorScrubbed:
              type: integer
            messagesCcBccStripped:
              type: integer
            attachmentsDeleted:
              type: integer
            storageObjectsRemoved:
              type: integer
            attachmentsUnresolved:
              type: integer
            inboundEmailsAnonymised:
              type: integer
          required:
            - customersDeleted
            - customerAliasesRemoved
            - ticketsRequesterScrubbed
            - ticketsCcBccStripped
            - messagesAuthorScrubbed
            - messagesCcBccStripped
            - attachmentsDeleted
            - storageObjectsRemoved
            - attachmentsUnresolved
            - inboundEmailsAnonymised
      required:
        - status
        - contentRedacted
        - cluster
        - unresolvedAttachmentIds
        - counts
  securitySchemes:
    bearerAuth:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.