---
title: "Withdraw a proposal or revoke a confirmed agent relationship"
method: DELETE
path: "/api/v2/accounts/agent-relationships"
tags: ["Account Endpoints"]
---

# Withdraw a proposal or revoke a confirmed agent relationship

`DELETE /api/v2/accounts/agent-relationships`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/accounts/agent-relationships`
- Auth: API key in header `x-api-key` and OpenID Connect (`https://auth.opensea.io/.well-known/openid-configuration`, scopes: `write:wallets`)
- TypeScript: <https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/accounts/agent-relationships/delete.ts> (a function with typed inputs; its response is checked against the schema)

Either party may remove the relationship at any point. Addressed exactly as confirm is: `counterparty_account_id` or `counterparty_address`, one of the two, plus your own side.

## Query parameters

- `counterparty_account_id` string
- `counterparty_address` string
- `caller_role` string, required

## Response `200`

OK

- AgentRelationshipRemovalResponse
  - `removed` boolean, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

## Changes

- **2026-11-03** `2c7935d84f90`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/accounts/agent-relationships/delete.md)

---

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