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 run-target checkout when workflow_source is omitted, or in the explicit workflow-source checkout when present.

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",
  "workflow_source": {
    "repo": "acme/workflows",
    "branch": "main",
    "tag": "v1.2.3"
  },
  "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 run-target checkout when workflow_source is omitted, or in the explicit workflow-source checkout when present.

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",
  "workflow_source": {
    "repo": "acme/workflows",
    "branch": "main",
    "tag": "v1.2.3"
  },
  "triggers": [
    {
      "id": "manual",
      "enabled": true
    }
  ]
}

Changes

Changed in 7 of the 172 revisions of this API.12619

Sep 19, 2026efc644ab09d45See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 31, 202618883371dc6f325See the full diff
- ▲
  added the new required request property /
  new-required-request-property
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ○
  added the new optional request property /
  new-optional-request-property
- ○
  added the new optional request property /
  new-optional-request-property
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 31, 20262ca60fd095f92See the full diff
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property to the response with the status
  response-optional-property-added
Aug 30, 20267bdeefd151cd12See the full diff
- ▲
  added the new required request property
  new-required-request-property
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
Aug 26, 20260a0810535f53734See the full diff
- ▲
  added the new required request property
  new-required-request-property
- ▲
  the request property type changed from object to no type
  request-property-type-changed
- ▲
  added to the response property oneOf list for the response status
  response-property-one-of-added
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ▲
  removed the required property / from the response with the status
  response-required-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ●
  removed the request property /
  request-property-removed
- ○
  added discriminator to request property
  request-property-discriminator-added
- ○
  added to the request property oneOf list
  request-property-one-of-added
- ○
  added discriminator to response property for the response status
  response-property-discriminator-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 30, 202657aaacdfd18e11See the full diff
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  removed the request property
  request-property-removed
May 27, 20265111129c56431See the full diff
- ○
  endpoint added
  endpoint-added

Full history