Skip to main content
POST
Create automation

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.