> ## Documentation Index
> Fetch the complete documentation index at: https://docs.intellibase.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Project

> Permanently delete a project and all its data

## Endpoint

```
DELETE https://api.intellibase.dev/api/v1/projects/{project_id}
```

## Path Parameters

<ParamField path="project_id" type="string" required>
  The unique identifier of the project to delete
</ParamField>

## Authentication

Requires a valid API key with access to the project.

## Response

Returns `204 No Content` on success (empty response body).

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.intellibase.dev/api/v1/projects/proj-abc123 \
    -H "Authorization: Bearer ib-your-api-key"
  ```

  ```python Python theme={null}
  import requests

  project_id = "proj-abc123"

  response = requests.delete(
      f"https://api.intellibase.dev/api/v1/projects/{project_id}",
      headers={"Authorization": "Bearer ib-your-api-key"}
  )

  if response.status_code == 204:
      print("Project successfully deleted")
  else:
      print(f"Error: {response.json()['detail']}")
  ```

  ```typescript TypeScript theme={null}
  const projectId = "proj-abc123";

  const response = await fetch(
    `https://api.intellibase.dev/api/v1/projects/${projectId}`,
    {
      method: "DELETE",
      headers: {
        "Authorization": "Bearer ib-your-api-key"
      }
    }
  );

  if (response.status === 204) {
    console.log("Project successfully deleted");
  } else {
    const error = await response.json();
    console.error(`Error: ${error.detail}`);
  }
  ```
</RequestExample>

<ResponseExample>
  ```text 204 No Content theme={null}
  (Empty response body)
  ```

  ```json 404 Not Found theme={null}
  {
    "detail": "Project proj-invalid not found"
  }
  ```

  ```json 403 Forbidden theme={null}
  {
    "detail": "You don't have access to this project"
  }
  ```

  ```json 500 Internal Server Error theme={null}
  {
    "detail": "Failed to delete vector data: connection timeout"
  }
  ```
</ResponseExample>

<Warning>
  **This action is irreversible!** Deleting a project permanently removes:

  * All ingested data (nodes, edges, chunks)
  * All vector embeddings
  * All metadata and provenance
  * All ingestion jobs history

  Make sure you have backups if needed before deleting.
</Warning>

<Info>
  The project itself is deleted, but the **ontology** used by the project is preserved. You can reuse it for new projects.
</Info>