---
title: "Create a tenant data deletion request"
method: POST
path: "/tenant/data-deletion-requests"
---

# Create a tenant data deletion request

`POST /tenant/data-deletion-requests`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/tenant/data-deletion-requests`
- Auth: HTTP bearer

Creates a durable deletion job with a cooling-off period and redacted support/audit record. A recently authenticated JWT identity is required unless an explicitly enabled service principal submits the request.

## Request body

- object
  - `request_id` string
  - `request_type` 'account_data_deletion' | 'connection_data_deletion' | 'connection_revoke_and_delete' | 'retention_purge' | 'tenant_data_deletion'
  - `reason_code` 'contract_termination' | 'customer_request' | 'other' | 'privacy_request' | 'provider_disconnect' | 'test_data'
  - `connection_id` string
  - `platform` string
  - `platform_account_ref` string: Opaque GravityAds control-plane account reference.
  - `platform_account_id_hash` string
  - `account_id_hash` string
  - `request_note` string
  - `send` boolean

## Response `200`

Redacted data deletion request

- object
  - `schema_version` 'gravityads.tenant_data_deletion_request.v1', required
  - `status` string, required
  - `request_type` string, required
  - `reason_code` string, required
  - `scope` object
  - `deletion_job` object
  - `support_ticket` object, required
    - `schema_version` 'gravityads.hosted_support_ticket.v1', required
    - `status` string, required
    - `ticket_id` string, required
    - `created_at_utc` string
    - `tenant_id_hash` string, required
    - `request_id_hash` string, required
    - `subject_hash` string, required
    - `subject_length` integer, required
    - `description_hash` string, required
    - `description_length` integer, required
    - `severity` string
    - `category` string
    - `support_provider` string
    - `provider_target_hash` string
    - `support_ticket_correlation_header` string
    - `ready_for_support_ticket_handoff` boolean
    - `send_requested` boolean
    - `send_blocker` string
    - `provider_called` boolean
    - `sent` boolean
    - `provider_status_code` integer
    - `external_ticket_id_hash` string
    - `provider_response_hash` string
    - `control_plane_record` object
    - `raw_ticket_payload_returned` false, required
    - `raw_provider_target_returned` false, required
    - `raw_secret_returned` false, required
  - `ops_followup` object
  - `next_actions` string[], required
  - `raw_account_ids_returned` false, required
  - `raw_customer_ids_returned` false, required
  - `raw_request_note_returned` false, required
  - `raw_ticket_payload_returned` false, required
  - `raw_secrets_returned` false, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)