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

# Archive a record

> Archive a record while preserving its history and allowing restoration.

Archive a record while preserving its history and allowing restoration.

Use a developer access key. See [authentication, errors, and rate limits](/api-reference/authentication).

Required scopes: `records:write`.

Repeated archive requests return the already archived record. Unknown or out-of-workspace records return `404`. This is not permanent deletion.

## Parameters

<ParamField path="recordId" type="string" required>
  Record ID in the key’s workspace.
</ParamField>

## Response

**200** — Returns the [record model](/api-reference/objects-and-records#record-response) under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "record_example",
      "objectTypeId": "object_example",
      "title": "Northlane",
      "avatarUrl": null,
      "values": {
        "field_name": "Northlane"
      },
      "archived": true,
      "createdBy": "user_example",
      "createdAt": "2026-09-07T12:00:00.000Z",
      "updatedAt": "2026-09-07T12:00:00.000Z"
    }
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    -X DELETE \
    "https://api.getkato.io/v1/records/$KATO_RECORD_ID" \
    -H "Authorization: Bearer $KATO_API_KEY"
  ```
</RequestExample>

Set path-ID environment variables to values returned by your workspace before running the request.

This request changes workspace data. A timeout does not prove that the write failed; inspect the result before retrying.


## Related topics

- [Objects and records API](/api-reference/objects-and-records.md)
- [All endpoints](/api-reference/endpoints.md)
- [Archive a task](/api-reference/tasks/archive.md)
- [Sync client records](/recipes/sync-client-records.md)
- [Authentication and API conventions](/api-reference/authentication.md)