# Delete a tool your organization built

> Delete a private tool your organization built, including all its methods.

Source: https://docs.fous.com/api-reference/deleteOwnTool

`DELETE /v1/tools/{api}`

Removes the private tool and every method of it. A public tool cannot be deleted. An agent key deletes as its person, who must be an owner or admin. Needs tools:write.

Authentication: `Authorization: Bearer $FOUS_API_KEY`.

## Path parameters

- `api` (string, required)

## Response 200

Success

- `success` (true, required)
- `data` (object, required)
  - `api` (string, required)
  - `action` ("delete", required)
  - `service_id` (string, required)

## Errors

Every error uses the Error schema: branch on `error.code`. Codes are listed at https://docs.fous.com/guides/errors.

- 400
- 401 (headers: WWW-Authenticate)
- 402
- 403
- 404
- 408
- 409
- 410
- 413
- 422
- 429 (headers: Retry-After)
- 500
- 502
- 503 (headers: Retry-After)
- 504

## Example request

```bash
curl 'https://api.fous.com/v1/tools/{api}' \
  -X DELETE \
  -H "Authorization: Bearer $FOUS_API_KEY"
```
