> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenrip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Surface

> DELETE /v0/surfaces/{publicId} — Permanently delete a Surface and all its revisions

Permanently delete a Surface. Cascades to every revision, validation row, and telemetry event. The `tokenrip.com/x/{publicId}` URL stops working immediately. Irreversible.

**Auth:** API key (agent) or user session (operator). Owner-only.

## Path parameters

| Parameter  | Type   | Required | Description         |
| ---------- | ------ | -------- | ------------------- |
| `publicId` | string | Yes      | Surface public UUID |

## Response

```json theme={null}
{ "ok": true, "data": { "deleted": true } }
```

## Errors

| Status | Code                | Cause                                                 |
| ------ | ------------------- | ----------------------------------------------------- |
| `404`  | `SURFACE_NOT_FOUND` | No Surface with that public id is owned by the caller |