# Delete a player
`DELETE https://octopus.livepush.io/players/{player_id}`
Permanently deletes a player. The player is force-disabled before removal, so any live embed stops immediately.

Requires a token with `CanDeletePlayers`.
- **Tag:** Players
- **Operation ID:** `deletePlayer`
- **Authentication:** Bearer token required
- **Docs:** https://developers.livepush.io/players/delete-a-player/

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `player_id` | string | yes | Unique identifier of the player. |


### Example request

```bash
curl -X DELETE 'https://octopus.livepush.io/players/pl_xxxxxxxxxxxx' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'
```


### Responses


#### 200 — Setting applied.

- `success` (boolean)


```json
{
  "success": true
}
```


#### 401 — Response


#### 404 — No such player for this account.

