DELETE · projects:write

Delete project permanently

Permanently delete a project and all its keywords, mentions, settings, and shared access. Requires the exact current project name as confirmationName and owner access. Frees keyword slots; preserves consumed monthly/trial mention usage and all billing/provider allowances. Emits project.deleted to workspace webhooks. This cannot be undone.

DestructiveExternal side effects

REST

DELETE/api/v1/projects/:projectId

curl "https://www.stalkr.ai/api/v1/projects/:projectId" \
  --request DELETE \
  --header "Authorization: Bearer $STALKR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: unique-operation-key"

MCP

Tool name: delete_project

The MCP tool accepts the same input schema and returns the same structured { data, meta } result as REST.

Input

confirmationNamerequired

string

Exact current project name, confirming permanent deletion. Keyword slots are freed; consumed mention usage is preserved.

projectIdrequired

string

idempotencyKey

string

Unique key used to safely retry this write operation

Safe retries

Pass idempotencyKey to the MCP tool or Idempotency-Key to REST when retrying this write.

Authorization

Required scope: projects:write.

Scope authorization is followed by resource authorization. Project operations check current membership and the minimum role required by the underlying workflow.

Related resources

REST conventions · MCP setup · Errors and limits