Skip to main content
GET
/
api
/
v0
/
machines
/
templates
/
{templateId}
Get a machine template
curl --request GET \
  --url https://api.factory.ai/api/v0/machines/templates/{templateId} \
  --header 'Authorization: Bearer <token>'
{
  "templateId": "<string>",
  "repoUrl": "<string>",
  "templateName": "<string>",
  "defaultBranch": "<string>",
  "createdBy": "<string>",
  "createdAt": 123,
  "buildStatus": {
    "status": "building",
    "failureReason": "setup_script_error",
    "buildStartedAt": 123,
    "builtAt": 123,
    "logs": "<string>"
  },
  "lastUpdatedAt": 123,
  "environmentVariables": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "userEnvironmentVariablesByUser": [
    {
      "key": "<string>",
      "value": "<string>"
    }
  ],
  "setupScript": "<string>"
}

Authorizations

Authorization
string
header
required

Factory API key or JWT token for authentication

Path Parameters

templateId
string
required

Template ID

Response

Response for status 200

templateId
string
required

Template ID

repoUrl
required

Repository URL

templateName
string
required

Human-readable template name

defaultBranch
string
required

Default branch name

createdBy
string
required

User ID of creator

createdAt
integer

Creation timestamp (ms)

buildStatus
object

Build status

lastUpdatedAt
integer | null

Last update timestamp (ms)

environmentVariables
object[]

Shared environment variables

userEnvironmentVariablesByUser
object[]

User-specific environment variables

setupScript
string

Setup script to run after cloning