---
title: "Re-run verification"
method: POST
path: "/v2/webhooks/{teamId}/{webhookId}/verify"
---

# Re-run verification

`POST /v2/webhooks/{teamId}/{webhookId}/verify`

Re-runs the GET challenge/echo handshake against the webhook's url and updates its verified state.

## Path parameters

- `teamId` string, uuid, required
- `webhookId` string, uuid, required

## Response `200`

The webhook, with a pending verification status (the handshake runs asynchronously).

- WebhookWithVerification — A registered webhook endpoint.
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, nullable
  - `url` string, uri, required — Endpoint events are delivered to.
  - `team_id` string, uuid, required
  - `enabled` boolean, required — Disabled webhooks are skipped at delivery time.
  - `verified` boolean, required — True once the endpoint has completed the verification handshake.
  - `verified_at` string, date-time, nullable
  - `verification_token` string — Stable token replayed to the endpoint (as the `micro_hook_token` query param) during the verification handshake. The endpoint may check it to confirm the request originated from Micro.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `verification` WebhookVerification — Status of the verification handshake enqueued by this request. The handshake runs asynchronously in the dispatcher; poll the webhook (its `verified` flag flips to true on success) to observe the outcome.
    - `status` 'pending', required — Always `pending` at the moment of the response — the dispatcher has been asked to run the handshake but has not reported back yet.

## Other responses

- `401` — Missing or invalid credentials. API Gateway maps a missing or invalid `x-api-key` to HTTP 401 with this envelope (including `request_id`). A 403 here means the key was accepted but the caller is not permitted.
- `403` — Authenticated but not permitted to perform this action.
- `404` — Resource or route does not exist.

## Changes

- **2026-06-29** `74d3dbb14f1d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/micro-so/apis/prism/changes/v2/webhooks/:teamId/:webhookId/verify/post.md)

---

[API](https://skmtc.dev/micro-so/apis/prism.md) · [All operations](https://skmtc.dev/micro-so/apis/prism/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/micro-so/prism/revisions/2b55e7c05657/schema)