Skip to main content
POST
/
api
/
v1
/
automations
Create automation
curl --request POST \
  --url https://api.example.com/api/v1/automations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "nightly-deps",
  "name": "Nightly dependency update",
  "target": {
    "repository": "fabro-sh/fabro",
    "ref": "main",
    "workflow": "dependency-update"
  },
  "triggers": [
    {
      "id": "manual",
      "type": "api",
      "enabled": true
    }
  ],
  "description": "Keeps dependencies fresh."
}
'
{
  "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",
      "type": "api",
      "enabled": true
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Raw dev token passed as Authorization: Bearer fabro_dev_... when server.auth.methods includes dev-token.

Body

application/json

Request body for creating an automation.

​
id
string
required
Pattern: ^[a-z0-9][a-z0-9-]{0,62}$
Example:

"nightly-deps"

​
name
string
required
Example:

"Nightly dependency update"

​
target
object
required

Repository and workflow selected by an automation.

​
triggers
object[]
required

Automation trigger configuration. Unknown type discriminator values are reported by handlers as domain validation errors with HTTP 422.

​
description
string | null
Example:

"Keeps dependencies fresh."

Response

Automation created

Public automation definition.

​
id
string
required
Pattern: ^[a-z0-9][a-z0-9-]{0,62}$
Example:

"nightly-deps"

​
revision
string
required

Stable revision used with If-Match for optimistic concurrency.

Pattern: ^[0-9a-f]{64}$
Example:

"0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"

​
name
string
required
Example:

"Nightly dependency update"

​
description
string | null
required
Example:

"Keeps dependencies fresh."

​
target
object
required

Repository and workflow selected by an automation.

​
triggers
object[]
required

Automation trigger configuration. Unknown type discriminator values are reported by handlers as domain validation errors with HTTP 422.