v106

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB

Automations

Create automation

Creates a new automation definition.

post/api/v1/automations

Request body

idstring required

namestring required

descriptionstring nullable

Example request

{
  "id": "nightly-deps",
  "name": "Nightly dependency update",
  "description": "Keeps dependencies fresh.",
  "target": {
    "repository": "fabro-sh/fabro",
    "ref": "main",
    "workflow": "dependency-update"
  },
  "triggers": [
    {
      "id": "manual",
      "enabled": true
    }
  ]
}

Response

Automation created

idstring required

revisionstring required

Stable revision used with If-Match for optimistic concurrency.

namestring required

descriptionstring nullable required

Example response

{
  "id": "nightly-deps",
  "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "name": "Nightly dependency update",
  "description": "Keeps dependencies fresh.",
  "target": {
    "repository": "fabro-sh/fabro",
    "ref": "main",
    "workflow": "dependency-update"
  },
  "triggers": [
    {
      "id": "manual",
      "enabled": true
    }
  ]
}