Automations

Create automation

Creates a new automation definition.

post/api/v1/automations

Request body

idstring required

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

{
  "id": "nightly-deps",
  "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 created

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

Changed in 4 of the 134 revisions of this API.947

Aug 30, 20267bdeefd151cd12See the full diff
- ▲
  added the new required request property environment_id
  new-required-request-property
- ○
  added the required property environment_id to the response with the 201 status
  response-required-property-added
- ○
  added the required property last_error to the response with the 201 status
  response-required-property-added
Aug 26, 20260a0810535f53734See the full diff
- ▲
  added the new required request property workflow
  new-required-request-property
- ▲
  the target request property type/format changed from object/ to /
  request-property-type-changed
- ▲
  added GitRunTarget NoneRunTarget FolderRunTarget to the target response property oneOf list for the response status 201
  response-property-one-of-added
- ▲
  the target response's property type/format changed from object/ to / for status 201
  response-property-type-changed
- ▲
  removed the required property target/ref from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property target/repository from the response with the 201 status
  response-required-property-removed
- ▲
  removed the required property target/workflow from the response with the 201 status
  response-required-property-removed
- ●
  removed the request property target/ref
  request-property-removed
- ●
  removed the request property target/repository
  request-property-removed
- ●
  removed the request property target/workflow
  request-property-removed
- ○
  added discriminator to target request property
  request-property-discriminator-added
- ○
  added GitRunTarget NoneRunTarget FolderRunTarget to the target request property oneOf list
  request-property-one-of-added
- ○
  added discriminator to target response property for the response status 201
  response-property-discriminator-added
- ○
  added the required property workflow to the response with the 201 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 enabled from the response with the 201 status
  response-required-property-removed
- ●
  removed the request property enabled
  request-property-removed
May 27, 20265111129c56431See the full diff
- ○
  endpoint added
  endpoint-added

Full history