Replace automation

curl --request PUT \
  --url https://api.example.com/api/v1/automations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'If-Match: <if-match>' \
  --data '
{
  "name": "Nightly dependency update",
  "environment_id": "daytona-smoke",
  "target": {
    "kind": "git",
    "repo": "acme/my-app",
    "branch": "feature/foo",
    "tag": "v1.2.3",
    "sha": "<string>"
  },
  "workflow": "dependency-update",
  "triggers": [
    {
      "id": "manual",
      "type": "api",
      "enabled": true
    }
  ],
  "description": "Keeps dependencies fresh."
}
'

import requests

url = "https://api.example.com/api/v1/automations/{id}"

payload = {
    "name": "Nightly dependency update",
    "environment_id": "daytona-smoke",
    "target": {
        "kind": "git",
        "repo": "acme/my-app",
        "branch": "feature/foo",
        "tag": "v1.2.3",
        "sha": "<string>"
    },
    "workflow": "dependency-update",
    "triggers": [
        {
            "id": "manual",
            "type": "api",
            "enabled": True
        }
    ],
    "description": "Keeps dependencies fresh."
}
headers = {
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Nightly dependency update',
    environment_id: 'daytona-smoke',
    target: {
      kind: 'git',
      repo: 'acme/my-app',
      branch: 'feature/foo',
      tag: 'v1.2.3',
      sha: '<string>'
    },
    workflow: 'dependency-update',
    triggers: [{id: 'manual', type: 'api', enabled: true}],
    description: 'Keeps dependencies fresh.'
  })
};

fetch('https://api.example.com/api/v1/automations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/automations/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Nightly dependency update',
    'environment_id' => 'daytona-smoke',
    'target' => [
        'kind' => 'git',
        'repo' => 'acme/my-app',
        'branch' => 'feature/foo',
        'tag' => 'v1.2.3',
        'sha' => '<string>'
    ],
    'workflow' => 'dependency-update',
    'triggers' => [
        [
                'id' => 'manual',
                'type' => 'api',
                'enabled' => true
        ]
    ],
    'description' => 'Keeps dependencies fresh.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "If-Match: <if-match>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/automations/{id}"

	payload := strings.NewReader("{\n  \"name\": \"Nightly dependency update\",\n  \"environment_id\": \"daytona-smoke\",\n  \"target\": {\n    \"kind\": \"git\",\n    \"repo\": \"acme/my-app\",\n    \"branch\": \"feature/foo\",\n    \"tag\": \"v1.2.3\",\n    \"sha\": \"<string>\"\n  },\n  \"workflow\": \"dependency-update\",\n  \"triggers\": [\n    {\n      \"id\": \"manual\",\n      \"type\": \"api\",\n      \"enabled\": true\n    }\n  ],\n  \"description\": \"Keeps dependencies fresh.\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("If-Match", "<if-match>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/api/v1/automations/{id}")
  .header("If-Match", "<if-match>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Nightly dependency update\",\n  \"environment_id\": \"daytona-smoke\",\n  \"target\": {\n    \"kind\": \"git\",\n    \"repo\": \"acme/my-app\",\n    \"branch\": \"feature/foo\",\n    \"tag\": \"v1.2.3\",\n    \"sha\": \"<string>\"\n  },\n  \"workflow\": \"dependency-update\",\n  \"triggers\": [\n    {\n      \"id\": \"manual\",\n      \"type\": \"api\",\n      \"enabled\": true\n    }\n  ],\n  \"description\": \"Keeps dependencies fresh.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/automations/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["If-Match"] = '<if-match>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Nightly dependency update\",\n  \"environment_id\": \"daytona-smoke\",\n  \"target\": {\n    \"kind\": \"git\",\n    \"repo\": \"acme/my-app\",\n    \"branch\": \"feature/foo\",\n    \"tag\": \"v1.2.3\",\n    \"sha\": \"<string>\"\n  },\n  \"workflow\": \"dependency-update\",\n  \"triggers\": [\n    {\n      \"id\": \"manual\",\n      \"type\": \"api\",\n      \"enabled\": true\n    }\n  ],\n  \"description\": \"Keeps dependencies fresh.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "nightly-deps",
  "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "name": "Nightly dependency update",
  "description": "Keeps dependencies fresh.",
  "environment_id": "daytona-smoke",
  "last_error": "<string>",
  "target": {
    "kind": "git",
    "repo": "acme/my-app",
    "branch": "feature/foo",
    "tag": "v1.2.3",
    "sha": "<string>"
  },
  "workflow": "dependency-update",
  "triggers": [
    {
      "id": "manual",
      "type": "api",
      "enabled": true
    }
  ],
  "workflow_source": {
    "repo": "acme/workflows",
    "branch": "main",
    "tag": "v1.2.3",
    "sha": "<string>"
  }
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

PUT

api

automations

{id}

Replace automation

curl --request PUT \
  --url https://api.example.com/api/v1/automations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'If-Match: <if-match>' \
  --data '
{
  "name": "Nightly dependency update",
  "environment_id": "daytona-smoke",
  "target": {
    "kind": "git",
    "repo": "acme/my-app",
    "branch": "feature/foo",
    "tag": "v1.2.3",
    "sha": "<string>"
  },
  "workflow": "dependency-update",
  "triggers": [
    {
      "id": "manual",
      "type": "api",
      "enabled": true
    }
  ],
  "description": "Keeps dependencies fresh."
}
'

import requests

url = "https://api.example.com/api/v1/automations/{id}"

payload = {
    "name": "Nightly dependency update",
    "environment_id": "daytona-smoke",
    "target": {
        "kind": "git",
        "repo": "acme/my-app",
        "branch": "feature/foo",
        "tag": "v1.2.3",
        "sha": "<string>"
    },
    "workflow": "dependency-update",
    "triggers": [
        {
            "id": "manual",
            "type": "api",
            "enabled": True
        }
    ],
    "description": "Keeps dependencies fresh."
}
headers = {
    "If-Match": "<if-match>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'If-Match': '<if-match>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Nightly dependency update',
    environment_id: 'daytona-smoke',
    target: {
      kind: 'git',
      repo: 'acme/my-app',
      branch: 'feature/foo',
      tag: 'v1.2.3',
      sha: '<string>'
    },
    workflow: 'dependency-update',
    triggers: [{id: 'manual', type: 'api', enabled: true}],
    description: 'Keeps dependencies fresh.'
  })
};

fetch('https://api.example.com/api/v1/automations/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/automations/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => 'Nightly dependency update',
    'environment_id' => 'daytona-smoke',
    'target' => [
        'kind' => 'git',
        'repo' => 'acme/my-app',
        'branch' => 'feature/foo',
        'tag' => 'v1.2.3',
        'sha' => '<string>'
    ],
    'workflow' => 'dependency-update',
    'triggers' => [
        [
                'id' => 'manual',
                'type' => 'api',
                'enabled' => true
        ]
    ],
    'description' => 'Keeps dependencies fresh.'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "If-Match: <if-match>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/automations/{id}"

	payload := strings.NewReader("{\n  \"name\": \"Nightly dependency update\",\n  \"environment_id\": \"daytona-smoke\",\n  \"target\": {\n    \"kind\": \"git\",\n    \"repo\": \"acme/my-app\",\n    \"branch\": \"feature/foo\",\n    \"tag\": \"v1.2.3\",\n    \"sha\": \"<string>\"\n  },\n  \"workflow\": \"dependency-update\",\n  \"triggers\": [\n    {\n      \"id\": \"manual\",\n      \"type\": \"api\",\n      \"enabled\": true\n    }\n  ],\n  \"description\": \"Keeps dependencies fresh.\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("If-Match", "<if-match>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.example.com/api/v1/automations/{id}")
  .header("If-Match", "<if-match>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"Nightly dependency update\",\n  \"environment_id\": \"daytona-smoke\",\n  \"target\": {\n    \"kind\": \"git\",\n    \"repo\": \"acme/my-app\",\n    \"branch\": \"feature/foo\",\n    \"tag\": \"v1.2.3\",\n    \"sha\": \"<string>\"\n  },\n  \"workflow\": \"dependency-update\",\n  \"triggers\": [\n    {\n      \"id\": \"manual\",\n      \"type\": \"api\",\n      \"enabled\": true\n    }\n  ],\n  \"description\": \"Keeps dependencies fresh.\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/automations/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["If-Match"] = '<if-match>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"Nightly dependency update\",\n  \"environment_id\": \"daytona-smoke\",\n  \"target\": {\n    \"kind\": \"git\",\n    \"repo\": \"acme/my-app\",\n    \"branch\": \"feature/foo\",\n    \"tag\": \"v1.2.3\",\n    \"sha\": \"<string>\"\n  },\n  \"workflow\": \"dependency-update\",\n  \"triggers\": [\n    {\n      \"id\": \"manual\",\n      \"type\": \"api\",\n      \"enabled\": true\n    }\n  ],\n  \"description\": \"Keeps dependencies fresh.\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "nightly-deps",
  "revision": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
  "name": "Nightly dependency update",
  "description": "Keeps dependencies fresh.",
  "environment_id": "daytona-smoke",
  "last_error": "<string>",
  "target": {
    "kind": "git",
    "repo": "acme/my-app",
    "branch": "feature/foo",
    "tag": "v1.2.3",
    "sha": "<string>"
  },
  "workflow": "dependency-update",
  "triggers": [
    {
      "id": "manual",
      "type": "api",
      "enabled": true
    }
  ],
  "workflow_source": {
    "repo": "acme/workflows",
    "branch": "main",
    "tag": "v1.2.3",
    "sha": "<string>"
  }
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found.",
      "code": "access_token_expired",
      "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "leftover_env_keys": [
    "<string>"
  ],
  "removed_env_keys": [
    "<string>"
  ]
}

Authorizations

Authorization

string

header

required

Raw dev token passed as Authorization: Bearer fabro_dev_... when server.auth.methods includes dev-token.

Headers

If-Match

string

required

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

Path Parameters

string

required

Unique automation identifier.

Pattern: ^[a-z0-9][a-z0-9-]{0,62}$

Body

application/json

Request body for replacing an automation.

name

string

required

Example:

"Nightly dependency update"

environment_id

string

required

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

Example:

"daytona-smoke"

target

object

required

Workspace content and location requested for a run.

Option 1
Option 2
Option 3

Show child attributes

workflow

string

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:

"dependency-update"

triggers

object[]

required

Automation trigger configuration. Unknown type discriminator values are reported by handlers as domain validation errors with HTTP 422.

Option 1
Option 2

Show child attributes

description

string | null

Example:

"Keeps dependencies fresh."

workflow_source

object

Explicit GitHub coordinate from which an automation acquires workflow bytes. The branch is the fallback selector and audit context. An optional tag overrides the branch, and an optional exact SHA overrides both without requiring branch ancestry. This source is independent of the run target and does not provide its working branch.

Show child attributes

Response

Automation replaced

Public automation definition.

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

environment_id

string | null

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.

Example:

"daytona-smoke"

last_error

string | null

required

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

target

object

required

Workspace content and location requested for a run.

Option 1
Option 2
Option 3

Show child attributes

workflow

string

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:

"dependency-update"

triggers

object[]

required

Automation trigger configuration. Unknown type discriminator values are reported by handlers as domain validation errors with HTTP 422.

Option 1
Option 2

Show child attributes

workflow_source

object

Show child attributes

Using the API

Workflow Versions

Runs

Human-in-the-Loop

Run Outputs

Automations

Environments

Variables

More

Replace automation

Authorizations

Headers

Path Parameters

Body

Response