Skip to main content
DELETE
Delete bare metal server

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Path Parameters

project_id
integer
required

Project ID.

Example:

1

server_id
string<uuid4>
required

Bare metal server ID.

Example:

"6c6aa80f-4234-4678-9abc-def012345678"

Query Parameters

all_floating_ips
boolean
default:false

Delete all floating IPs associated with the server's ports. Default preserves them (disassociate only). Mutually exclusive with floating_ip_ids.

all_ports
boolean
default:false

Delete all ports attached to the bare metal server. Default preserves them (detach only; the trunk is dissolved but every port survives, reusable elsewhere). Mutually exclusive with port_ids.

dry_run
boolean
default:false

Run every check of the real request and change nothing. The response has the status code and the schema of the real call, and an empty list of tasks. With false, the default, the request does the operation.

floating_ip_ids
string<uuid4>[]

Floating IP IDs to delete; the rest are preserved. Mutually exclusive with all_floating_ips.

Example:

"75757793-5e33-4eed-ab5d-9ed5030e57f7"

port_ids
string<uuid4>[]

Port IDs to delete; the rest are preserved. Mutually exclusive with all_ports.

Example:

"75757793-5e33-4eed-ab5d-9ed5030e57f7"

Response

Task IDs, and the other resources that the delete removes or keeps

resources_to_delete
BaremetalCascadeResourceSerializer · object[]
required

Every resource that this request deletes: the server, and each port and floating IP that goes with it. Sorted by type, then by id.

resources_to_preserve
BaremetalCascadeResourceSerializer · object[]
required

The ports and floating IPs of the server that stay after the delete. Sorted by type, then by id.

tasks
string[]
required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
Example: