Data Subject Requests

​

Authentication

X-DSR-SECRET: your_dsr_secret_key

​

Delete profile data

​

Request

curl --request POST \
  --url https://integrations.theswarm.com/dsr/profiles \
  --header 'Content-Type: application/json' \
  --header 'X-DSR-SECRET: <API key>' \
  --data '{
    "emails": ["user@example.com"],
    "linkedin_url": "https://linkedin.com/in/username"
  }'

​

Parameters

​

Responses

{
  "message": "Requested processed"
}

{
  "status": 400,
  "title": "Validation failed",
  "errors": [
    {
      "path": "<field>",
      "violation": "<error message>"
    }
  ]
}

{
  "status": 500
}

​

How it works

1. Immediate removal - The profile data is deleted from all Swarm databases upon a successful request
2. Permanent exclusion - The profile is added to an exclusion list, preventing re-import during future data refreshes
3. Audit trail - All DSR requests are logged for compliance purposes

​

Best practices

• Process DSR requests within your required compliance timeframe (e.g., GDPR requires 30 days)
• Maintain records of DSR requests for compliance audits
• Test with non-production data before implementing in your workflow