---
title: "Remove JSON and append state.deleted atomically"
method: DELETE
path: "/api/v1/addresses/{addressId}/state/{key}"
tags: ["State"]
---

# Remove JSON and append state.deleted atomically

`DELETE /api/v1/addresses/{addressId}/state/{key}`

## Request

- Base URL: `https://agentaddress.dev`
- URL: `https://agentaddress.dev/api/v1/addresses/{addressId}/state/{key}`
- Auth: HTTP bearer

## Path parameters

- `addressId` string, required
- `key` string, required

## Headers

- `If-Match` string

## Response `200`

Authorized response; never cached

- StateDeleted
  - `key` string, required
  - `deleted` boolean, required
  - `revision` integer, required
  - `event_id` string
  - `updated_at` string, date-time

## Other responses

- `400`: Structured API error
- `401`: Structured API error
- `404`: Structured API error
- `409`: Structured API error
- `429`: Wait Retry-After seconds; minute, hourly or UTC daily window applies

---

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