DELETE /v1/config/projects/{id}

Permanently deletes a project, along with its log sources, repos, channels, analyses, follow-ups, feedback, postmortems, watchdog rules, API keys, and access list.

This is irreversible. There's no recovery from a delete. The default project cannot be deleted; every tenant must keep one project to receive new analyses.

Authentication

API key with config:write permission.

Endpoint

DELETE /v1/config/projects/{id}

Path parameters

Param	Type	Notes
`id`	UUID	The project id

Request body

{
  "confirm": "<exact-project-slug>"
}

Field	Type	Required	Notes
`confirm`	string	yes	Must match the target project's `slug` exactly. The API rejects empty or non-matching values with `400 CONFIRMATION_MISMATCH`.

The confirmation gate prevents accidental deletes from a leaked or miscopied key. Legitimate IaC tear-down still works — Terraform already has the slug it provisioned with.

Response

200 OK

{
  "success": true,
  "data": {
    "deleted": true
  }
}

Error responses

Status	`error.code`	When
400	`VALIDATION_ERROR`	`id` is not a valid UUID
400	`CONFIRMATION_MISMATCH`	Body missing `confirm`, or `confirm` doesn't match the project's slug
400	`CANNOT_DELETE_DEFAULT`	The target project is the tenant's default project
401	`UNAUTHORIZED`	Missing or invalid API key
403	`FORBIDDEN`	Key lacks `config:write`
404	`NOT_FOUND`	No project with that id in your tenant

Example

curl -X DELETE https://api.sigsentry.com/v1/config/projects/6f1c89bb-3b50-4c4a-9c5f \
  -H "Authorization: Bearer ss_secret_..." \
  -H "Content-Type: application/json" \
  -d '{ "confirm": "checkout-prod" }'

What gets deleted

Deleting a project removes all of its scoped resources:

Log sources, repos, and notification channels
Analyses, follow-ups, feedback, and postmortems
Watchdog rules
API keys scoped to this project
The project's access list

Tenant-scoped resources (tenant-wide API keys, billing, members) are unaffected.