systemd Machine Info API

The Machine Info API from systemd — 4 operation(s) for machine info.

Documentation

Specifications

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/systemd-machine-info-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

systemd-machine-info-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: systemd-hostnamed (org.freedesktop.hostname1) Boot Machine Info API
  version: '1.0'
  summary: D-Bus API of systemd-hostnamed modeled as REST operations.
  description: 'Documentation/contract artifact for the `org.freedesktop.hostname1` D-Bus interface on the

    system bus. Manages the system hostname (static, transient, pretty), chassis type, deployment,

    location, icon name, and other machine info.

    '
  license:
    name: LGPL-2.1-or-later
    url: https://github.com/systemd/systemd/blob/main/LICENSES/LGPL-2.1-or-later.txt
servers:
- url: dbus://system/org.freedesktop.hostname1
tags:
- name: Machine Info
paths:
  /chassis:
    put:
      tags:
      - Machine Info
      operationId: SetChassis
      summary: Set The Chassis Type
      description: Mirrors `SetChassis(chassis, interactive)`. One of `desktop`, `laptop`, `server`, `tablet`, `handset`, `embedded`, `vm`, `container`, `convertible`, `watch`.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                chassis:
                  type: string
                interactive:
                  type: boolean
      responses:
        '204':
          description: Updated.
  /deployment:
    put:
      tags:
      - Machine Info
      operationId: SetDeployment
      summary: Set The Deployment Environment
      description: Mirrors `SetDeployment(deployment, interactive)`. Free-form tag like `production`/`staging`.
      responses:
        '204':
          description: Updated.
  /location:
    put:
      tags:
      - Machine Info
      operationId: SetLocation
      summary: Set The Location String
      description: Mirrors `SetLocation(location, interactive)`.
      responses:
        '204':
          description: Updated.
  /describe:
    get:
      tags:
      - Machine Info
      operationId: DescribeHostname
      summary: Describe All Hostname/Machine-Info Properties
      description: Mirrors `Describe()`. Returns a JSON dump of every hostname property.
      responses:
        '200':
          description: JSON dump.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true