Clear the deploy hook call log

clear_deploy_hook_calls

Hides a site's stored deploy hook call log and reports how many calls went.

POST /v1/clear_deploy_hook_callsScopeconfig:writeDestructive

Pass a hookId to clear the log of one hook, or leave it out for every hook on the site. Cleared calls stop appearing in listings and counts at once and are erased from the database 30 days later. The hooks themselves and their URLs are untouched and keep working.

It needs the Delete projects permission in the workspace, the same one the Settings tab of Deploy hooks asks for. See Deploy hooks.

Request

Call it with a POST to https://api.modulify.ai/v1/clear_deploy_hook_calls, sending the inputs below as a JSON object. The token needs the config:write scope.

This method is marked destructive: it deletes or overwrites data. Check the inputs before you call it, and send an Idempotency-Key header whenever you might retry it.

curl -X POST https://api.modulify.ai/v1/clear_deploy_hook_calls \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"PROJECT_ID"}'

Over MCP, the same method is the clear_deploy_hook_calls tool.

Inputs

Input	Type	Required	Description
`projectId`	string	Yes	The site id.
`hookId`	string	No	Clear only this hook. Leave it out to clear the log of every hook on the site.

Response

Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.