# Delete a project

> Remove an empty project.

`DELETE https://api.codebuckets.clatterlabs.xyz/v1/projects/{project_id}` (key permission: `buckets:write`)

Deletes a project that has no buckets left. It disappears from your lists and the API.

## Authorizations

- `Authorization` (string, required): Your API key as a bearer token: `Bearer clsk_...`. Create keys in the [Console](https://console.clatterlabs.com/api-keys) with the Code Buckets permissions you need.
- `X-Clatter-Account` (string, required): The Account ID that owns the key, like `CL-7K2M9QXA`. Find it in Console › Settings. A missing value answers `401 missing_account_id`; someone else's answers `401 account_mismatch`.

## Path parameters

- `project_id` (string, required): The Project ID (`cbp_…`).

## Response

- `object` (string): `project`.
- `id` (string): The Project ID.
- `deleted` (boolean): `true`.

## Example request

```bash
curl -X DELETE "https://api.codebuckets.clatterlabs.xyz/v1/projects/PROJECT_ID" \
  -H "Authorization: Bearer $CLATTER_API_KEY" \
  -H "X-Clatter-Account: $CLATTER_ACCOUNT_ID"
```

## Errors

| Status | Code | When |
| --- | --- | --- |
| `401` | `invalid_api_key / missing_account_id / account_mismatch` | The key or Account ID is wrong. |
| `402` | `quota_exceeded` | This month's free tokens are used up. |
| `403` | `insufficient_scope` | The key lacks the permission. |
| `404` | `not_found` | No project with that id on your account. |
| `409` | `project_not_empty` | Delete the project's buckets first. |

## Example response

```json
{
  "object": "project",
  "id": "cbp_4k9x2m7q1n8v3c6z0b5w",
  "deleted": true
}
```