DELETE /api/v1/boot/{machine_id}/profile
Delete a machine’s boot profile and its associated blobs
Delete a machine’s boot profile and its associated blobs.
Sequence Diagram
sequenceDiagram
participant Client as Admin Client
participant Boot as Boot Service
participant Storage as Cloud Storage
participant DB as Firestore
Client->>Boot: DELETE /api/v1/boot/{machine_id}/profile
Boot->>DB: Get kernel_id and initrd_id
DB-->>Boot: Blob IDs
Boot->>Storage: DELETE gs://bucket/blobs/{kernel_id}
Boot->>Storage: DELETE gs://bucket/blobs/{initrd_id}
Boot->>DB: Delete boot profile
Boot-->>Client: 204 No ContentRequest
Path Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
machine_id | string | Yes | Machine identifier (UUIDv7 format) |
Example Request:
DELETE /api/v1/boot/018c7dbd-c000-7000-8000-fedcba987654/profile HTTP/1.1
Host: boot.example.com
Response
Response (204 No Content):
Empty response body.
Error Responses:
All error responses follow RFC 7807 Problem Details format (see ADR-0007) with Content-Type: application/problem+json.
404 Not Found - Machine not found or has no boot profile:
{
"type": "https://api.example.com/errors/boot-profile-not-found",
"title": "Boot Profile Not Found",
"status": 404,
"detail": "No boot profile found for machine 018c7dbd-c000-7000-8000-fedcba987654",
"instance": "/api/v1/boot/018c7dbd-c000-7000-8000-fedcba987654/profile",
"machine_id": "018c7dbd-c000-7000-8000-fedcba987654"
}