Skip to content
Fleeti

Get profile configuration

GET
/api/v1/profiles/{id}

Returns the latest visible profile metadata and configuration for the authenticated API key owner.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Profile identifier.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Latest profile configuration.

object
profile
required
object
id
required

Profile identifier.

string
fleet_id

Primary fleet identifier when one is available.

string
fleet_ids
required

All fleet identifiers assigned to the profile.

Array<string>
fleet_name

Human-readable name of the primary fleet.

string
name
required

Profile name.

string
description

Optional profile description.

string
latest_revision
required

Latest known profile revision.

integer
config_hash

Hash of the latest configuration revision when available.

string
created_at
required

UTC timestamp string returned by the current API implementation.

string
config_schema_version
required

Current configuration schema version for the latest revision.

integer
config
required

Canonical JSON configuration object for the latest profile revision.

object
key
additional properties
any
packages
required

Parsed package list from the profile configuration.

Array<string>
kernel
required
object
attr

Selected kernel attribute.

string
source_override
required
object
enabled
required
boolean
url
string format: uri
ref
string
rev
string
patches
required
Array<object>
object
name
required
string
sha256
required
string
content_base64
required
string
openclaw_microvm_enabled
required

Whether the OpenClaw MicroVM integration is enabled.

boolean
raw_nix

Raw Nix overrides stored with the latest profile revision.

string
Examples

Example response

{
  "profile": {
    "id": "a8ce71df-4c80-4d45-919a-bfd474a4d724",
    "fleet_id": "fleet-primary",
    "fleet_ids": [
      "fleet-primary",
      "fleet-secondary"
    ],
    "fleet_name": "Primary Fleet, Secondary Fleet",
    "name": "Production Base",
    "description": "Base image for production devices.",
    "latest_revision": 12,
    "config_hash": "b7b98f7c4cf1a9dcbf8a1a5a35da1431f34a9d48973026e5f86f4cc6b6d5d7dd",
    "config_schema_version": 1,
    "created_at": "2026-03-18 12:00:00",
    "config": {
      "packages": [
        "vim",
        "curl"
      ],
      "kernel": {
        "attr": "linux_6_19",
        "source_override": {
          "enabled": true,
          "url": "https://github.com/example/linux.git",
          "ref": "refs/heads/main",
          "rev": "abcd1234abcd1234abcd1234abcd1234abcd1234",
          "patches": [
            {
              "name": "0001-fix.patch",
              "sha256": "be6f08ca3e84fdbcf9f53c778f1944f24591b31af08c74f81f6ff497f57a5717",
              "content_base64": "ZGlmZiAtLWdpdCBhL2ZvbyBiL2Zvbwo="
            }
          ]
        }
      },
      "openclaw_microvm_enabled": true
    },
    "packages": [
      "vim",
      "curl"
    ],
    "kernel": {
      "attr": "linux_6_19",
      "source_override": {
        "enabled": true,
        "url": "https://github.com/example/linux.git",
        "ref": "refs/heads/main",
        "rev": "abcd1234abcd1234abcd1234abcd1234abcd1234",
        "patches": [
          {
            "name": "0001-fix.patch",
            "sha256": "be6f08ca3e84fdbcf9f53c778f1944f24591b31af08c74f81f6ff497f57a5717",
            "content_base64": "ZGlmZiAtLWdpdCBhL2ZvbyBiL2Zvbwo="
          }
        ]
      }
    },
    "openclaw_microvm_enabled": true,
    "raw_nix": "{ pkgs, ... }: {}"
  }
}

401

Section titled “401 ”

Missing or invalid API key.

object
error
required
string

404

Section titled “404 ”

Profile not found or not visible to the authenticated user.

object
error
required
string
Examples

Missing profile

{
  "error": "Profile not found"
}