GET /api/v1/boot/{machine_id}/profile
Retrieve the active boot profile for a specific machine
Retrieve the active boot profile for a specific machine.
Sequence Diagram
sequenceDiagram
participant Client as Admin Client
participant Boot as Boot Service
participant DB as Firestore
Client->>Boot: GET /api/v1/boot/{machine_id}/profile
Boot->>DB: Query active boot profile for machine
DB-->>Boot: Boot profile
Boot-->>Client: 200 OK (boot profile)Request
Path Parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
machine_id | string | Yes | Machine identifier (UUIDv7 format) |
Example Request:
GET /api/v1/boot/018c7dbd-c000-7000-8000-fedcba987654/profile HTTP/1.1
Host: boot.example.com
Response
Response (200 OK):
{
"id": "018c7dbd-a000-7000-8000-abcdef123456",
"machine_id": "018c7dbd-c000-7000-8000-fedcba987654",
"kernel": {
"id": "018c7dbd-b100-7000-8000-123456789abc",
"args": ["console=tty0", "console=ttyS0", "ip=dhcp"]
},
"initrd": {
"id": "018c7dbd-b200-7000-8000-987654321fed"
}
}
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"
}