State Backed
GET /machines/{machineSlug}
Bearer auth

Retrieve the machine definition

Path parameters

  • machineSlug string Required

    The slug/name for the machine definition.

    Minimum length is 1. Format should match the following pattern: ^[a-zA-Z0-9_-]{1,128}$.

Responses

  • 200 application/json

    The machine was retrieved successfully.

    Hide response attribute Show response attribute object
    • machine object Required
      Hide machine attributes Show machine attributes object
      • createdAt string(date-time) Required
      • currentVersion object
        Hide currentVersion attributes Show currentVersion attributes object
        • id string Required

          The ID of a machine definition version.

        • createdAt string(date-time) Required
        • clientInfo string Required
      • indexes array[string] Required

        Name of an index on machines

        Format of each should match the following pattern: ^[a-zA-Z0-9_-]{1,128}$.
  • 403 application/json

    The request was unauthorized.

    Hide response attributes Show response attributes object
    • error string

      A description of the error.

    • code string

      A code specifying the type of error.

      Values are missing-scope, rejected-by-machine-authorizer, missing-user, or missing-org.
GET /machines/{machineSlug} 
curl \
 --request GET 'https://api.statebacked.dev/machines/my-machine' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "machine": {
    "createdAt": "2026-05-04T09:42:00Z",
    "currentVersion": {
      "id": "string",
      "createdAt": "2026-05-04T09:42:00Z",
      "clientInfo": "string"
    },
    "indexes": [
      "string"
    ]
  }
}
Response examples (403) 
{
  "error": "string",
  "code": "missing-scope"
}