Trash & restore

Deleting a record doesn’t destroy it. Every DELETE on a record — people, companies, deals, notes, tasks, activities, and custom-object records — soft-deletes it: the record moves to a per-workspace trash, stays recoverable for 30 days, then is permanently purged. There is deliberately no hard-delete, so an agent can never irreversibly destroy your data.

Endpoints

Method	Path	Purpose
`GET`	`/trash/{resource}`	List trashed records of a type
`POST`	`/trash/{resource}/{id}/restore`	Restore a record from the trash

{resource} is one of people, companies, deals, notes, tasks, activities, custom-objects. Any other value returns 400.

List the trash

curl $SALTY_API/trash/people \
  -H "Authorization: Bearer $SALTY_API_KEY"

{
  "data": [
    {
      "id": "08e7e7d4-31ff-4456-bd99-731252edb54c",
      "resource": "people",
      "label": "Ada Lovelace",
      "deleted_at": "2026-06-23T02:00:00Z"
    }
  ]
}

label is a human-readable summary of the record (a person’s name/email, a company name, a deal name, a note snippet, …). Up to 100 most-recently-deleted records are returned.

Restore

curl -X POST $SALTY_API/trash/people/08e7e7d4-.../restore \
  -H "Authorization: Bearer $SALTY_API_KEY"

{ "id": "08e7e7d4-31ff-4456-bd99-731252edb54c", "restored": true }

Restoring re-counts the record against your plan’s record cap. If you’re already at the cap, restore returns 402 with code records_cap_exceeded — free up space or upgrade, then retry. Restoring a record that isn’t in the trash returns 404.

After 30 days a trashed record is hard-deleted by a daily purge and can no longer be restored.

​Endpoints

​List the trash

​Restore

Endpoints

List the trash

Restore