Delete Check

Remove a check from a playbook.

DELETE /api/v1/playbooks/{playbook_id}/checks/{check_id}

cURL

curl -X DELETE "https://api.wordsmith.ai/api/v1/playbooks/3804d3f1-ba8c-4d5e-97f7-c16466d0ece9/checks/a43c9368-519f-46f8-9dc3-7d76ab58837f" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

204

No body.

Preview. This endpoint is available to organisations in the Wordsmith MCP pilot. Other organisations receive 403 mcp_not_enabled. See the preview overview.

Removes one check from a playbook. Reviews that start after this call no longer run it.

Past reviews keep their findings for the check, including its id and name. Deletes are REST-only: no MCP tool deletes a check.

Authentication

Requires an API key, or an OAuth token with playbooks:write.

Path parameters

playbook_id · string · required

The playbook that holds the check.

check_id · string · required

The check to remove.

Response

Returns 204 No Content with no body.

cURL

curl -X DELETE "https://api.wordsmith.ai/api/v1/playbooks/3804d3f1-ba8c-4d5e-97f7-c16466d0ece9/checks/a43c9368-519f-46f8-9dc3-7d76ab58837f" \
  -H "Authorization: Bearer sk-ws-api1-your_api_key_here"

204

No body.

Errors

Status	error_code	When
403	forbidden	The caller can read the playbook but not edit it, or it is a global playbook.
404	resource_not_found	No playbook or check with these ids, or the caller cannot read the playbook.