Automations

Retrieve automation

Returns one automation definition by id.

get/api/v1/automations/{id}

Path parameters

idstring required

Unique automation identifier.

Response

Automation definition

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.65

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

Full history