Re-run verification

Changed on

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

post/v2/webhooks/{teamId}/{webhookId}/verify

Request

  • Base URL
    https://developers.micro.so
  • URL
    https://developers.micro.so/v2/webhooks/{teamId}/{webhookId}/verify
  • Auth
    API key in header x-api-key

Path parameters

teamIdstring uuid required
webhookIdstring uuid required

Response

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

idstring uuid required
namestring required
descriptionstring nullable
urlstring uri required

Endpoint events are delivered to.

team_idstring uuid required
enabledboolean required

Disabled webhooks are skipped at delivery time.

verifiedboolean required

True once the endpoint has completed the verification handshake.

verified_atstring date-time nullable
verification_tokenstring

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_atstring date-time required
updated_atstring date-time nullable

Changes