Skip to content

Remove a VPS from a placement group

DELETE /api/v2/placement-groups/{id}/members/{vpsId}

Take a VPS out of a placement group. The VPS keeps running where it is and is no longer kept apart from the other members. Returns 204 with no body. It also returns 204 when the VPS was not a member.

Authentication: An API key with the scope write:vm. About keys and scopes

Request

Path parameters

idstringrequired
The placement group ID (pg_…).
vpsIdstringrequired
The VPS ID (vps_…) from the group’s members[].vpsId.

Example

DELETE /api/v2/placement-groups/{id}/members/{vpsId}
curl -X DELETE "https://cloud.hostup.se/api/v2/placement-groups/pg_01hxa3b4c5d6e7f8g9h0j1k2m3/members/id_01hxa3b4c5d6e7f8g9h0j1k2m3" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

204 The VPS is no longer in the group.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404placement_group_not_found: no such group in your account. vps_not_found: vpsId is not a VPS ID.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.