---
updatedAt: 2026-06-25T09:42:58.000Z
agentTools:
  projectIndex: https://marketing.developer.dotdigital.com/llms.txt
---

# Delete record from an account Insight data collection

Deletes a single record from a specified Insight data collection

<span class="callRateMedium"></span>

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Insight data service",
    "description": "Manage Insight data collections and records at both account and contact level. Use this API to bulk-import records via asynchronous upsert, retrieve and update individual records, create and delete collections, empty collections, and poll the status of import or asynchronous operations. Insight data makes structured behavioural and transactional data — such as orders, product catalogues, and web activity — available to drive personalisation, segmentation, and product recommendations across your campaigns.\n",
    "version": "3.3.1"
  },
  "externalDocs": {
    "description": "Learn more about Dotdigital APIs",
    "url": "https://developer.dotdigital.com"
  },
  "servers": [
    {
      "url": "https://{region}-api.dotdigital.com",
      "variables": {
        "region": {
          "description": "The Dotdigital region id your account belongs to",
          "enum": [
            "r1",
            "r2",
            "r3"
          ],
          "default": "r1"
        }
      }
    }
  ],
  "security": [
    {
      "basicAuth": []
    }
  ],
  "paths": {
    "/insightData/v3/account/{collectionName}/{recordId}": {
      "delete": {
        "summary": "Delete record from an account Insight data collection",
        "description": "Deletes a single record from a specified Insight data collection",
        "operationId": "delAccountInsightDataRecord",
        "parameters": [
          {
            "name": "collectionName",
            "in": "path",
            "description": "Insight data collection name",
            "required": true,
            "schema": {
              "maxLength": 255,
              "pattern": "(^[-A-Za-z_][-A-Za-z0-9_]{1,255}$)",
              "type": "string"
            }
          },
          {
            "name": "recordId",
            "in": "path",
            "description": "Unique ID for the Insight data record",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "x-ddg-integration-token",
            "in": "header",
            "description": "If you are a partner of Dotdigital and have a [verified integration](https://developer.dotdigital.com/docs/partner-integration-verification) then include your [integration tracking token](https://developer.dotdigital.co/docs/verified-integration-tracking) here.",
            "required": false,
            "schema": {
              "pattern": "/^(?:\\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\\}{0,1})$/",
              "type": "string",
              "example": "5a96bc79-19a7-4544-973b-e2da0c9136f9"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Insight data record deleted"
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errorResponse"
                },
                "example": {
                  "errorCode": "insightData:invalidId",
                  "description": "The collectionName value 'My collection' is invalid"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/errorResponse"
                },
                "examples": {
                  "collectionNotFound": {
                    "summary": "Collection not found",
                    "value": {
                      "errorCode": "insightData:collectionNotFound",
                      "description": "The collection could not be found",
                      "details": [
                        {
                          "item": "myOrders",
                          "description": "Not found"
                        }
                      ]
                    }
                  },
                  "recordNotFound": {
                    "summary": "Record not found",
                    "value": {
                      "errorCode": "insightData:recordNotFound",
                      "description": "The Insight data record could not be found",
                      "details": [
                        {
                          "item": "24938",
                          "description": "Not found in the contacts collection '{collectionName}'"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "errorResponse": {
        "required": [
          "description",
          "errorCode"
        ],
        "type": "object",
        "properties": {
          "errorCode": {
            "type": "string",
            "description": "Unique error code"
          },
          "description": {
            "type": "string",
            "description": "Description of the issue"
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/errorResponse_details"
            }
          }
        }
      },
      "errorResponse_details": {
        "required": [
          "description",
          "item"
        ],
        "type": "object",
        "properties": {
          "item": {
            "type": "string",
            "description": "Item the error is associated with, for example, field name, unique identifier for an entity or item in batch"
          },
          "description": {
            "type": "string",
            "description": "Description of the error"
          }
        }
      }
    },
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "x-samples-languages": [
    "curl",
    "csharp",
    "java",
    "javascript",
    "node",
    "python",
    "php",
    "ruby"
  ]
}
```

# Sibling pages

* [List account Insight data collections](https://marketing.developer.dotdigital.com/reference/getaccountinsightdatacollections.md)
* [Retrieves records from an accounts Insight data collection](https://marketing.developer.dotdigital.com/reference/getaccountinsightdata.md)
* [Retrieve single record from an account Insight data collection](https://marketing.developer.dotdigital.com/reference/getaccountinsightdatarecord.md)
* [Upsert record into an account Insight data collection](https://marketing.developer.dotdigital.com/reference/putaccountinsightdatarecord.md)
* [Deletes multiple records from an account scoped Insight Data collection.](https://marketing.developer.dotdigital.com/reference/delaccountinsightdatarecords.md)