---
title: "Remove contact"
method: POST
path: "/api/v1/agent/contacts/remove"
tags: ["agentApiContacts"]
---

# Remove contact

`POST /api/v1/agent/contacts/remove`

Removes contact by handle or ID. Both directions of the contact relationship are removed.

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `contact_id` string, uuid — Or contact record ID
  - `handle` string — Contact's handle

## Response `200`

Removed

- ContactsRemoveAgentContactResponse200 — unresolved $ref

## Other responses

- `400` — Bad request - neither handle nor contact_id provided
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.dev/band/apis/request-api.md) · [All operations](https://skmtc.dev/band/apis/request-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/band/request-api/revisions/3cff423845a2/schema)