---
title: "Delete an object"
method: DELETE
path: "/v2/objects/{object}"
tags: ["Objects"]
---

# Delete an object

`DELETE /v2/objects/{object}`

## Request

- Base URL: `https://api.attio.com`
- URL: `https://api.attio.com/v2/objects/{object}`
- Auth: OAuth 2
  - Authorization code: `https://app.attio.com/authorize`
  - Token URL: `https://app.attio.com/oauth/token` scopes: `object_configuration:read-write`, `record_permission:read-write`

Deletes a single object by its `object_id` or slug, along with all of its records. Only custom objects can be deleted; system objects, such as people and companies, cannot.

This endpoint should be used with caution as it has the potential to remove a large amount of potentially valuable data.

Required scopes: `object_configuration:read-write`, `record_permission:read-write`.

Supported token levels: `workspace`, `user`.

## Path parameters

- `object` string, required: A UUID or slug to identify the object.

## Response `200`

Success

- object: Success

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found

## Changes

- **2026-09-04** `01c36eb5773e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/attio/apis/attio-api/changes/v2/objects/:object/delete.md)

---

[API](https://skmtc.dev/attio/apis/attio-api.md) - [All operations](https://skmtc.dev/attio/apis/attio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/attio/apis/attio-api/revisions/7d2c7472b378?raw)