# Delete project

`DELETE /v1/projects/{project}`, operation `projects.DeleteProject`

Requests a project's deletion, and returns it in DELETE_REQUESTED. Nothing in it works from then on but reading it and its IAM policy and restoring it: its agents and environments stop, and its service accounts' keys stop working. kosem purges it, with everything in it, at its purgeTime, 30 days later, unless UndeleteProject restores it first. Deleting it again fails with permission_denied, as resourcemanager.projects.delete no longer holds in it.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `project` | path | Yes | `string` | The project's ID. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `createTime` | `string (date-time)` | Yes | When the project was created. |
| `deleteTime` | `string (date-time)` | No | When its deletion was requested; absent while it is active. |
| `displayName` | `string` | Yes | Name shown in user interfaces. |
| `name` | `string` | Yes | Resource name, projects/{project_id}. The ID is generated by the server and never changes. |
| `parent` | `string` | Yes | The organization the project belongs to, organizations/{organization_id}. |
| `purgeTime` | `string (date-time)` | No | When kosem purges it, with everything in it, 30 days after its deletion was requested, unless it is undeleted first; absent while it is active. |
| `slug` | `string` | Yes | Globally unique, human-readable alias. It never changes, so that links to the project keep working. |
| `state` | `string` | Yes | Lifecycle state. Nothing in a project whose deletion was requested works but reading and restoring it, and it is purged at its purgeTime unless it is undeleted first. Values: `ACTIVE`, `DELETE_REQUESTED`. |
| `updateTime` | `string (date-time)` | Yes | When the project was last updated. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.