> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mediakind.ferndocs.com/platform/how-to/fleets/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mediakind.ferndocs.com/_mcp/server.

# Build with the Fleets API

The Fleets API is the operational API for MK.IO Beam devices. Use it to register devices into a project, protect their configuration with backups, manage software versions, and collect support packages when you need diagnostics.

## API overview

| Detail    | Value                                    |
| --------- | ---------------------------------------- |
| Base path | `/api/v1/projects/{project_name}/fleet/` |
| Scope     | Project                                  |
| Reference | [Fleets API reference](/beam/api/fleets) |

## How the main resources connect

The Fleets API revolves around a few resource types:

* A device represents the Beam device record in MK.IO.

* A backup is a configuration snapshot you can restore later.

* Software settings on the device control desired and preloaded versions.

* A support package is a diagnostic bundle generated on the device and uploaded to storage.

That means a typical operational flow is: register the device, take backups before risky changes, control software state through device patch operations, and collect support packages when something goes wrong.

## Common workflow patterns

### Operate a Beam device

1

[Register and manage devices](/platform/how-to/fleets/device-management)

2

[Back up configuration before changes](/platform/how-to/fleets/backups-and-restores)

3

[Control software versions](/platform/how-to/fleets/software-and-updates)

4

[Collect a support package for diagnostics](/platform/how-to/fleets/software-and-updates)

## Guides

[](/platform/how-to/fleets/device-management)

### Manage devices

Register devices, inspect state, and work through the core day-to-day operations.

[](/platform/how-to/fleets/backups-and-restores)

### Backups and restores

Create backups before changes, inspect stored backup metadata, and restore safely.

[](/platform/how-to/fleets/software-and-updates)

### Software and updates

Control desired and preloaded software versions and collect support packages for diagnostics.

## Docs

- [Backups and restores](https://mediakind.ferndocs.com/platform/how-to/fleets/backups-and-restores.md)
- [Manage devices](https://mediakind.ferndocs.com/platform/how-to/fleets/device-management.md)
- [Software and updates](https://mediakind.ferndocs.com/platform/how-to/fleets/software-and-updates.md)