Skip to content

Delete the webhook

Stops event delivery for the survey and discards its signing secret.

HTTP request

DELETE https://www.asqiro.com/api/v1/surveys/{id}/webhook

An API key created by a workspace member who can edit. A viewer's key answers 403.

Path parameters

ParameterTypeDescription
idstringThe survey id, as returned by the surveys endpoints.Required

Response body

A successful call returns 204 with an empty body.

Errors

  • unauthorized · 401 · The API key is missing, malformed, deleted, or its creator lost workspace access. Check the Authorization header, then the key itself.
  • forbidden · 403 · The key is valid but lacks the access this call needs - most often a read-only key attempting a write.
  • not_found · 404 · No survey with that id is reachable by this key. A survey in another workspace answers the same way as one that does not exist.
  • plan_upgrade_required · 403 · The workspace owner's plan does not include API access. Upgrading the plan restores it; retrying will not.
  • rate_limited · 429 · Too many requests. The Retry-After response header carries the number of seconds to wait.

Example request

bash
curl -X DELETE "https://www.asqiro.com/api/v1/surveys/s_7t2qk8wvbf31/webhook" \
  -H "Authorization: Bearer $ASQIRO_API_KEY" \
  -i

Returns 204 on success.

Example response
http
HTTP/1.1 204 No Content