Buy with Prime | Developer Documentation
Documentation

personalDataDeletionTask

Version 2024-01-01

📘

Important

The Buy with Prime API is offered as a preview and might change as we receive feedback and iterate on the interfaces. We are sharing this early documentation to help you learn about the Buy with Prime API as we write and iterate on the content.

Overview

Returns a single personal data deletion task.

ℹ️

Required scope(s)

Manage Shopper Privacy Requests

Response

Return type PersonalDataDeletionTask

Arguments

ArgumentDescription
taskId (String required)

Specifies the identifier to retrieve a personal data deletion task.

Examples

Personal Data Deletion Task With Error

Request

query {
    personalDataDeletionTask(taskId: "3556a10a-6b0c-481f-a02e-3950c53f12b3") {
        taskId
        status
        submissionDate
        lastUpdatedDate
        dataSubject {
            type
            email
        }
        holdingPeriod
        errors {
            code
            message
        }
    }
}

Response

{
  "data": {
    "personalDataDeletionTask": {
      "taskId": "3556a10a-6b0c-481f-a02e-3950c53f12b3",
      "status": "FAILED",
      "submissionDate": "2024-01-12T20:19:34.638498Z",
      "lastUpdatedDate": "2024-01-12T20:19:35.070533Z",
      "dataSubject": {
        "type": "SHOPPER",
        "email": "[email protected]"
      },
      "holdingPeriod": 0,
      "errors": [
        {
          "code": "DATA_SUBJECT_NOT_FOUND",
          "message": "The shopper email for request 3556a10a-6b0c-481f-a02e-3950c53f12b3 does not exist"
        }
      ]
    }
  }
}

Personal Data Deletion Task

Request

query {
    personalDataDeletionTask(taskId: "edee74fa-e2d2-422d-a557-809d64bb9ea9") {
        taskId
        status
        submissionDate
        dataSubject {
            type
            email
        }
        holdingPeriod
    }
}

Response

{
  "data": {
    "personalDataDeletionTask": {
      "taskId": "edee74fa-e2d2-422d-a557-809d64bb9ea9",
      "status": "ON_HOLD",
      "submissionDate": "2023-10-31T18:21:15.851865Z",
      "dataSubject": {
        "type": "SHOPPER",
        "email": "[email protected]"
      },
      "holdingPeriod": 5
    }
  }
}

Non Exist Error

Request

query {
    personalDataDeletionTask(taskId: "1d2ca67f-f5de-4114-91a7-95a9de0feaa1") {
        taskId
        status
        submissionDate
        lastUpdatedDate
        dataSubject {
            type
            email
        }
        holdingPeriod
    }
}

Response

{
  "errors": [
    {
      "message": "Request references a resource which does not exist.",
      "locations": [
        {
          "line": 2,
          "column": 3
        }
      ],
      "path": [
        "personalDataDeletionTask"
      ],
      "extensions": {
        "classification": {
          "type": "ResourceNotFoundError",
          "errorType": "ResourceNotFoundException",
          "errorCode": 404
        }
      }
    }
  ],
  "data": {
    "personalDataDeletionTask": null
  }
}

Updated 2 days ago