---
title: "Permanently delete a profile from your workspace."
method: DELETE
path: "/profiles/{profileId}"
tags: ["Profile"]
---

# Permanently delete a profile from your workspace.

`DELETE /profiles/{profileId}`

## Request

- Base URL: `http://localhost:5050`
- URL: `http://localhost:5050/profiles/{profileId}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/kameleo-io/apis/kameleo-local-api/docs/profiles/:profileId/delete.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `profileId` string, uuid, required

## Response `200`

OK.

## Other responses

- `401`: Unauthorized
- `404`: Profile not found.
- `409`: Profile is running.
- `default`: Error

## Changes

- **2026-08-03** `dc959e78ce25`: 4 warning
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `404`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `409`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `default`
- **2026-06-16** `4d1d53a322e2`: 8 warning, 28 info
  - removed the optional property `code` from the response with the `401` status
  - removed the optional property `code` from the response with the `404` status
  - removed the optional property `code` from the response with the `409` status
  - removed the optional property `code` from the response with the `default` status
  - …32 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/changes/profiles/:profileId/delete.md)

---

[API](https://skmtc.dev/kameleo-io/apis/kameleo-local-api.md) - [All operations](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/revisions/d3225562612a?raw)