---
title: "Manually verify a contact channel"
method: POST
path: "/v1/contact-channels/{channel_id}/verify"
tags: ["contacts"]
---

# Manually verify a contact channel

`POST /v1/contact-channels/{channel_id}/verify`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/contact-channels/{channel_id}/verify`
- Auth: none declared

Guardian-only manual attestation: marks the channel active/verified in the gateway store (source of truth) with a best-effort assistant mirror. Idempotent.

## Path parameters

- `channel_id` string, required

## Response `200`

Successful response

- object
  - `ok` boolean, required
  - `channel` object, required
    - `id` string, required
    - `contactId` string, required
    - `type` string, required
    - `address` string, required
    - `isPrimary` boolean, required
    - `externalChatId` string, nullable, required
    - `status` string, nullable, required
    - `policy` string, nullable, required
    - `verifiedAt` number, nullable, required
    - `verifiedVia` string, nullable, required
    - `inviteId` string, nullable, required
    - `revokedReason` string, nullable, required
    - `blockedReason` string, nullable, required
    - `lastSeenAt` number, nullable, required
    - `interactionCount` number, required
    - `lastInteraction` number, nullable, required
    - `createdAt` number, nullable, required
    - `updatedAt` number, nullable, required

## Changes

- **2026-07-06** `bf6a3a734a63`: 1 info
  - endpoint added
- **2026-06-15** `8aa43f77a604`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/changes/v1/contact-channels/:channel_id/verify/post.md)

---

[API](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api.md) - [All operations](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vellum-ai/apis/vellum-gateway-api/revisions/48d611686235?raw)