---
title: "Delete a certain agent."
method: DELETE
path: "/api/v1/projects/{projectId}"
tags: ["Agents"]
---

# Delete a certain agent.

`DELETE /api/v1/projects/{projectId}`

Delete an agent (formerly known as project) by its unique project ID. This endpoint allows you to remove an existing agent from the system based on its ID.
Here is an example to delete an agent: [API](https://github.com/Poll-The-People/customgpt-cookbook/blob/main/examples/Delete_a_project.ipynb) [SDK](https://github.com/Poll-The-People/customgpt-cookbook/blob/main/examples/SDK_Delete_a_project.ipynb).

## Path parameters

- `projectId` integer, required

## Response `200`

Agent deleted successfully

- object
  - `status` 'error' | 'success' — The status of the response
  - `data` object
    - `deleted` boolean — Whether the agent was deleted successfully or not

## Other responses

- `400` — Bad Argument
- `401` — API Token is either missing or invalid
- `404` — Agent not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/poll-the-people/apis/customgpt-ai.md) · [All operations](https://skmtc.net/poll-the-people/apis/customgpt-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poll-the-people/customgpt-ai/revisions/b80e6dfcf78d/schema)