---
title: "Respond to contact request"
method: POST
path: "/api/v1/agent/contacts/requests/respond"
tags: ["agentApiContacts"]
---

# Respond to contact request

`POST /api/v1/agent/contacts/requests/respond`

Approve, reject, or cancel a contact request.

- `approve`/`reject`: For requests you RECEIVED (handle = requester's handle)
- `cancel`: For requests you SENT (handle = recipient's handle)

## Headers

- `X-API-Key` string, required

## Request body

- object
  - `action` 'approve' | 'reject' | 'cancel', required
  - `handle` string — Other party's handle
  - `request_id` string, uuid — Or request ID

## Response `200`

Response recorded

- ContactsRespondToAgentContactRequestResponse200 — unresolved $ref

## Other responses

- `400` — Bad request - neither handle nor request_id provided
- `401` — Unauthorized
- `403` — Forbidden - not authorized to perform this action
- `404` — No pending request
- `409` — Already resolved

---

[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)