Sign in
Automations

Replace automation

Replaces an automation definition when If-Match matches the current automation revision.

put/api/v1/automations/{id}

Path parameters

idstring required

Unique automation identifier.

Headers

If-Matchstring required

Current resource revision used for optimistic concurrency, as returned in the ETag response header.

Request body

namestring required
descriptionstring nullable
environment_idstring required

Server-managed Docker or Daytona environment selected when the automation fires.

workflowstring required

Workflow slug or path resolved in the selected repository checkout.

Example request

{
  "name": "Nightly dependency update",
  "description": "Keeps dependencies fresh.",
  "environment_id": "daytona-smoke",
  "target": {
    "repo": "acme/my-app",
    "branch": "feature/foo",
    "tag": "v1.2.3"
  },
  "workflow": "dependency-update",
  "triggers": [
    {
      "id": "manual",
      "enabled": true
    }
  ]
}

Response

Automation replaced

idstring required
revisionstring required

Stable revision used with If-Match for optimistic concurrency.

namestring required
descriptionstring nullable required
environment_idstring nullable required

Server-managed Docker or Daytona environment selected when the automation fires. Null only for an incomplete definition migrated from a release that predated environment selection.

last_errorstring nullable required

Most recent scheduled-run failure, cleared after a scheduled run is queued successfully.

workflowstring required

Workflow slug or path resolved in the selected repository checkout.

Example response

{
  "id": "nightly-deps",
  "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "name": "Nightly dependency update",
  "description": "Keeps dependencies fresh.",
  "environment_id": "daytona-smoke",
  "target": {
    "repo": "acme/my-app",
    "branch": "feature/foo",
    "tag": "v1.2.3"
  },
  "workflow": "dependency-update",
  "triggers": [
    {
      "id": "manual",
      "enabled": true
    }
  ]
}

Changes