Sample - Asana API
PUT/webhooks/{webhook_gid}

Update webhook filters

Updates the filters for an existing webhook. Supply the replacement filters array in the data block; the previous filter set is completely overwritten rather than merged. Use opt_fields to request optional webhook properties in the response.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated optional webhook properties to include in the response, such as `active`, `filters`, `last_success_at`, and `next_attempt_after`.

Replacement webhook filter configuration.

dataobjectoptional
The webhook update object containing the complete replacement `filters` array.

6 status codes
200Returns the updated webhook with its replacement filters and other requested webhook properties.
dataobjectoptional
400Returned when the request is missing or malformed, including invalid filter data or request syntax.
errorsarray<object>optional
401Returned when a valid authentication token is not provided.
errorsarray<object>optional
403Returned when the authenticated user lacks access to the webhook or the required `webhooks:write` scope.
errorsarray<object>optional
404Returned when the request path is not recognized or the specified webhook does not exist.
errorsarray<object>optional
500Returned when a server-side problem prevents the webhook update; the response may include an error phrase.
errorsarray<object>optional

Error handling

A 400 is returned when the filters data or request syntax is malformed. A 401 is returned without a valid authentication token, and a 403 is returned when the authenticated user cannot update the webhook or lacks the webhooks:write scope. A 404 is returned when the webhook does not exist, while a 500 indicates a server-side failure.