# Delete a planet

`DELETE /planets/{planetId}`

This endpoint was used to delete planets. Unfortunately, that caused a lot of trouble for planets with life. So, this endpoint is now deprecated and should not be used anymore.

Base URL: https://galaxy.scalar.com, https://void.scalar.com/

## Authorization

- bearerAuth: HTTP bearer
- basicAuth: HTTP basic
- apiKeyQuery: API key in query `api_key`
- apiKeyHeader: API key in header `X-API-Key`
- apiKeyCookie: API key in cookie `api_key`
- oAuth2: oauth2
- openIdConnect: openIdConnect

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `planetId` | path | integer | yes | The ID of the planet to get |

## Responses

### 204: No Content

### 404: Not Found

Returns `NotFoundError`.

- `type` (string)
- `title` (string)
- `status` (integer)
- `detail` (string)

```json
{
  "type": "https://example.com/errors/not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "The resource you are trying to access does not exist."
}
```

## Example request

```bash
curl -X DELETE 'https://galaxy.scalar.com/planets/{planetId}' \
  -H 'Authorization: Basic <base64-credentials>' \
  -H 'X-API-Key: <X-API-Key>'
```