ChatGPT ↗
Claude ↗This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.
Delete is a soft archive through the same versioned note-update path. The note and its revision history remain stored. List archived notes with archived=true; restore with PATCH and archived=false. Links to Deals, leads, and companies remain organization-scoped.
Path parameters
note_idrequiredstring
Exact note ID.
| Name | Type | Description |
|---|---|---|
| note_idrequired | string | Exact note ID. |
Body parameters
expected_versionrequiredinteger
Current note version, at least 1. A stale value returns 409.
idempotency_keyrequiredstring
Unique 8–200 character key for this archive request. Reuse the same key and body to retry.
| Name | Type | Description |
|---|---|---|
| expected_versionrequired | integer | Current note version, at least 1. A stale value returns 409. |
| idempotency_keyrequired | string | Unique 8–200 character key for this archive request. Reuse the same key and body to retry. |
Errors
| Status | Meaning |
|---|---|
| 401 | Missing or invalid authentication. |
| 403 | Missing notes:write scope. |
| 404 | Note not found in this organization. |
| 409 | Stale version or idempotency-key conflict. |
| 422 | Invalid version or idempotency key. |