Create Automation

curl --request POST \
  --url https://api.tryreplicas.com/v1/automations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "triggers": [
    {
      "config": {
        "schedule": "0 9 * * 1-5",
        "timezone": "America/New_York"
      }
    }
  ],
  "prompt": "<string>",
  "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "scope": "org",
  "debounce_seconds": 43200,
  "github_check_names": [
    "<string>"
  ],
  "enabled": true,
  "workspace_auto_stop_minutes": 721,
  "workspace_size": "small",
  "config": {
    "capabilities": {
      "pr_followups": true,
      "read_only_contents": true
    },
    "preferences": {
      "keep_open_on_pr_merge": false,
      "keep_open_on_pr_close": false
    },
    "provisioning_error": {
      "message": "<string>"
    }
  },
  "model": "<string>",
  "plan_mode": true,
  "goal_mode": true,
  "fast_mode": true
}
'

import requests

url = "https://api.tryreplicas.com/v1/automations"

payload = {
    "name": "<string>",
    "triggers": [{ "config": {
                "schedule": "0 9 * * 1-5",
                "timezone": "America/New_York"
            } }],
    "prompt": "<string>",
    "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "description": "<string>",
    "scope": "org",
    "debounce_seconds": 43200,
    "github_check_names": ["<string>"],
    "enabled": True,
    "workspace_auto_stop_minutes": 721,
    "workspace_size": "small",
    "config": {
        "capabilities": {
            "pr_followups": True,
            "read_only_contents": True
        },
        "preferences": {
            "keep_open_on_pr_merge": False,
            "keep_open_on_pr_close": False
        },
        "provisioning_error": { "message": "<string>" }
    },
    "model": "<string>",
    "plan_mode": True,
    "goal_mode": True,
    "fast_mode": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    triggers: [{config: {schedule: '0 9 * * 1-5', timezone: 'America/New_York'}}],
    prompt: '<string>',
    environment_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    description: '<string>',
    scope: 'org',
    debounce_seconds: 43200,
    github_check_names: ['<string>'],
    enabled: true,
    workspace_auto_stop_minutes: 721,
    workspace_size: 'small',
    config: {
      capabilities: {pr_followups: true, read_only_contents: true},
      preferences: {keep_open_on_pr_merge: false, keep_open_on_pr_close: false},
      provisioning_error: {message: '<string>'}
    },
    model: '<string>',
    plan_mode: true,
    goal_mode: true,
    fast_mode: true
  })
};

fetch('https://api.tryreplicas.com/v1/automations', 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.tryreplicas.com/v1/automations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'triggers' => [
        [
                'config' => [
                                'schedule' => '0 9 * * 1-5',
                                'timezone' => 'America/New_York'
                ]
        ]
    ],
    'prompt' => '<string>',
    'environment_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'description' => '<string>',
    'scope' => 'org',
    'debounce_seconds' => 43200,
    'github_check_names' => [
        '<string>'
    ],
    'enabled' => true,
    'workspace_auto_stop_minutes' => 721,
    'workspace_size' => 'small',
    'config' => [
        'capabilities' => [
                'pr_followups' => true,
                'read_only_contents' => true
        ],
        'preferences' => [
                'keep_open_on_pr_merge' => false,
                'keep_open_on_pr_close' => false
        ],
        'provisioning_error' => [
                'message' => '<string>'
        ]
    ],
    'model' => '<string>',
    'plan_mode' => true,
    'goal_mode' => true,
    'fast_mode' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.tryreplicas.com/v1/automations"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"triggers\": [\n    {\n      \"config\": {\n        \"schedule\": \"0 9 * * 1-5\",\n        \"timezone\": \"America/New_York\"\n      }\n    }\n  ],\n  \"prompt\": \"<string>\",\n  \"environment_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"description\": \"<string>\",\n  \"scope\": \"org\",\n  \"debounce_seconds\": 43200,\n  \"github_check_names\": [\n    \"<string>\"\n  ],\n  \"enabled\": true,\n  \"workspace_auto_stop_minutes\": 721,\n  \"workspace_size\": \"small\",\n  \"config\": {\n    \"capabilities\": {\n      \"pr_followups\": true,\n      \"read_only_contents\": true\n    },\n    \"preferences\": {\n      \"keep_open_on_pr_merge\": false,\n      \"keep_open_on_pr_close\": false\n    },\n    \"provisioning_error\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"model\": \"<string>\",\n  \"plan_mode\": true,\n  \"goal_mode\": true,\n  \"fast_mode\": true\n}")

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

	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.post("https://api.tryreplicas.com/v1/automations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"triggers\": [\n    {\n      \"config\": {\n        \"schedule\": \"0 9 * * 1-5\",\n        \"timezone\": \"America/New_York\"\n      }\n    }\n  ],\n  \"prompt\": \"<string>\",\n  \"environment_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"description\": \"<string>\",\n  \"scope\": \"org\",\n  \"debounce_seconds\": 43200,\n  \"github_check_names\": [\n    \"<string>\"\n  ],\n  \"enabled\": true,\n  \"workspace_auto_stop_minutes\": 721,\n  \"workspace_size\": \"small\",\n  \"config\": {\n    \"capabilities\": {\n      \"pr_followups\": true,\n      \"read_only_contents\": true\n    },\n    \"preferences\": {\n      \"keep_open_on_pr_merge\": false,\n      \"keep_open_on_pr_close\": false\n    },\n    \"provisioning_error\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"model\": \"<string>\",\n  \"plan_mode\": true,\n  \"goal_mode\": true,\n  \"fast_mode\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tryreplicas.com/v1/automations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"triggers\": [\n    {\n      \"config\": {\n        \"schedule\": \"0 9 * * 1-5\",\n        \"timezone\": \"America/New_York\"\n      }\n    }\n  ],\n  \"prompt\": \"<string>\",\n  \"environment_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"description\": \"<string>\",\n  \"scope\": \"org\",\n  \"debounce_seconds\": 43200,\n  \"github_check_names\": [\n    \"<string>\"\n  ],\n  \"enabled\": true,\n  \"workspace_auto_stop_minutes\": 721,\n  \"workspace_size\": \"small\",\n  \"config\": {\n    \"capabilities\": {\n      \"pr_followups\": true,\n      \"read_only_contents\": true\n    },\n    \"preferences\": {\n      \"keep_open_on_pr_merge\": false,\n      \"keep_open_on_pr_close\": false\n    },\n    \"provisioning_error\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"model\": \"<string>\",\n  \"plan_mode\": true,\n  \"goal_mode\": true,\n  \"fast_mode\": true\n}"

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

{
  "automation": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "triggers": [
      {
        "config": {
          "schedule": "0 9 * * 1-5",
          "timezone": "America/New_York"
        }
      }
    ],
    "prompt": "<string>",
    "debounce_seconds": 43200,
    "github_check_names": [
      "<string>"
    ],
    "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "enabled": true,
    "webhook_token": "<string>",
    "cron_expression": "<string>",
    "cron_timezone": "<string>",
    "cron_next_fire_at": "2023-11-07T05:31:56Z",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_auto_stop_minutes": 721,
    "config": {
      "capabilities": {
        "pr_followups": true,
        "read_only_contents": true
      },
      "preferences": {
        "keep_open_on_pr_merge": false,
        "keep_open_on_pr_close": false
      },
      "provisioning_error": {
        "message": "<string>"
      }
    },
    "model": "<string>",
    "plan_mode": true,
    "goal_mode": true,
    "fast_mode": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

POST

automations

Create Automation

curl --request POST \
  --url https://api.tryreplicas.com/v1/automations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "triggers": [
    {
      "config": {
        "schedule": "0 9 * * 1-5",
        "timezone": "America/New_York"
      }
    }
  ],
  "prompt": "<string>",
  "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "scope": "org",
  "debounce_seconds": 43200,
  "github_check_names": [
    "<string>"
  ],
  "enabled": true,
  "workspace_auto_stop_minutes": 721,
  "workspace_size": "small",
  "config": {
    "capabilities": {
      "pr_followups": true,
      "read_only_contents": true
    },
    "preferences": {
      "keep_open_on_pr_merge": false,
      "keep_open_on_pr_close": false
    },
    "provisioning_error": {
      "message": "<string>"
    }
  },
  "model": "<string>",
  "plan_mode": true,
  "goal_mode": true,
  "fast_mode": true
}
'

import requests

url = "https://api.tryreplicas.com/v1/automations"

payload = {
    "name": "<string>",
    "triggers": [{ "config": {
                "schedule": "0 9 * * 1-5",
                "timezone": "America/New_York"
            } }],
    "prompt": "<string>",
    "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "description": "<string>",
    "scope": "org",
    "debounce_seconds": 43200,
    "github_check_names": ["<string>"],
    "enabled": True,
    "workspace_auto_stop_minutes": 721,
    "workspace_size": "small",
    "config": {
        "capabilities": {
            "pr_followups": True,
            "read_only_contents": True
        },
        "preferences": {
            "keep_open_on_pr_merge": False,
            "keep_open_on_pr_close": False
        },
        "provisioning_error": { "message": "<string>" }
    },
    "model": "<string>",
    "plan_mode": True,
    "goal_mode": True,
    "fast_mode": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    triggers: [{config: {schedule: '0 9 * * 1-5', timezone: 'America/New_York'}}],
    prompt: '<string>',
    environment_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    description: '<string>',
    scope: 'org',
    debounce_seconds: 43200,
    github_check_names: ['<string>'],
    enabled: true,
    workspace_auto_stop_minutes: 721,
    workspace_size: 'small',
    config: {
      capabilities: {pr_followups: true, read_only_contents: true},
      preferences: {keep_open_on_pr_merge: false, keep_open_on_pr_close: false},
      provisioning_error: {message: '<string>'}
    },
    model: '<string>',
    plan_mode: true,
    goal_mode: true,
    fast_mode: true
  })
};

fetch('https://api.tryreplicas.com/v1/automations', 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.tryreplicas.com/v1/automations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'triggers' => [
        [
                'config' => [
                                'schedule' => '0 9 * * 1-5',
                                'timezone' => 'America/New_York'
                ]
        ]
    ],
    'prompt' => '<string>',
    'environment_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'description' => '<string>',
    'scope' => 'org',
    'debounce_seconds' => 43200,
    'github_check_names' => [
        '<string>'
    ],
    'enabled' => true,
    'workspace_auto_stop_minutes' => 721,
    'workspace_size' => 'small',
    'config' => [
        'capabilities' => [
                'pr_followups' => true,
                'read_only_contents' => true
        ],
        'preferences' => [
                'keep_open_on_pr_merge' => false,
                'keep_open_on_pr_close' => false
        ],
        'provisioning_error' => [
                'message' => '<string>'
        ]
    ],
    'model' => '<string>',
    'plan_mode' => true,
    'goal_mode' => true,
    'fast_mode' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$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.tryreplicas.com/v1/automations"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"triggers\": [\n    {\n      \"config\": {\n        \"schedule\": \"0 9 * * 1-5\",\n        \"timezone\": \"America/New_York\"\n      }\n    }\n  ],\n  \"prompt\": \"<string>\",\n  \"environment_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"description\": \"<string>\",\n  \"scope\": \"org\",\n  \"debounce_seconds\": 43200,\n  \"github_check_names\": [\n    \"<string>\"\n  ],\n  \"enabled\": true,\n  \"workspace_auto_stop_minutes\": 721,\n  \"workspace_size\": \"small\",\n  \"config\": {\n    \"capabilities\": {\n      \"pr_followups\": true,\n      \"read_only_contents\": true\n    },\n    \"preferences\": {\n      \"keep_open_on_pr_merge\": false,\n      \"keep_open_on_pr_close\": false\n    },\n    \"provisioning_error\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"model\": \"<string>\",\n  \"plan_mode\": true,\n  \"goal_mode\": true,\n  \"fast_mode\": true\n}")

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

	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.post("https://api.tryreplicas.com/v1/automations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"triggers\": [\n    {\n      \"config\": {\n        \"schedule\": \"0 9 * * 1-5\",\n        \"timezone\": \"America/New_York\"\n      }\n    }\n  ],\n  \"prompt\": \"<string>\",\n  \"environment_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"description\": \"<string>\",\n  \"scope\": \"org\",\n  \"debounce_seconds\": 43200,\n  \"github_check_names\": [\n    \"<string>\"\n  ],\n  \"enabled\": true,\n  \"workspace_auto_stop_minutes\": 721,\n  \"workspace_size\": \"small\",\n  \"config\": {\n    \"capabilities\": {\n      \"pr_followups\": true,\n      \"read_only_contents\": true\n    },\n    \"preferences\": {\n      \"keep_open_on_pr_merge\": false,\n      \"keep_open_on_pr_close\": false\n    },\n    \"provisioning_error\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"model\": \"<string>\",\n  \"plan_mode\": true,\n  \"goal_mode\": true,\n  \"fast_mode\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.tryreplicas.com/v1/automations")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"triggers\": [\n    {\n      \"config\": {\n        \"schedule\": \"0 9 * * 1-5\",\n        \"timezone\": \"America/New_York\"\n      }\n    }\n  ],\n  \"prompt\": \"<string>\",\n  \"environment_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"description\": \"<string>\",\n  \"scope\": \"org\",\n  \"debounce_seconds\": 43200,\n  \"github_check_names\": [\n    \"<string>\"\n  ],\n  \"enabled\": true,\n  \"workspace_auto_stop_minutes\": 721,\n  \"workspace_size\": \"small\",\n  \"config\": {\n    \"capabilities\": {\n      \"pr_followups\": true,\n      \"read_only_contents\": true\n    },\n    \"preferences\": {\n      \"keep_open_on_pr_merge\": false,\n      \"keep_open_on_pr_close\": false\n    },\n    \"provisioning_error\": {\n      \"message\": \"<string>\"\n    }\n  },\n  \"model\": \"<string>\",\n  \"plan_mode\": true,\n  \"goal_mode\": true,\n  \"fast_mode\": true\n}"

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

{
  "automation": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "description": "<string>",
    "triggers": [
      {
        "config": {
          "schedule": "0 9 * * 1-5",
          "timezone": "America/New_York"
        }
      }
    ],
    "prompt": "<string>",
    "debounce_seconds": 43200,
    "github_check_names": [
      "<string>"
    ],
    "environment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "enabled": true,
    "webhook_token": "<string>",
    "cron_expression": "<string>",
    "cron_timezone": "<string>",
    "cron_next_fire_at": "2023-11-07T05:31:56Z",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_auto_stop_minutes": 721,
    "config": {
      "capabilities": {
        "pr_followups": true,
        "read_only_contents": true
      },
      "preferences": {
        "keep_open_on_pr_merge": false,
        "keep_open_on_pr_close": false
      },
      "provisioning_error": {
        "message": "<string>"
      }
    },
    "model": "<string>",
    "plan_mode": true,
    "goal_mode": true,
    "fast_mode": true,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

{
  "error": "<string>",
  "details": "<string>"
}

Authorizations

Authorization

string

header

required

API key authentication. Obtain your API key from the Replicas dashboard under Organization → Settings → API Keys. User-session JWTs are not accepted by /v1/replica endpoints.

Body

application/json

Request body for creating a new automation. The automation runs in a single environment specified by environment_id.

name

string

required

Human-readable name for the automation

triggers

object[]

required

One or more triggers. Duplicates are not allowed: at most one cron trigger, and at most one event-based trigger per event (e.g. two triggers for pull_request.opened is rejected, but pull_request.opened + merge_request.opened is fine).

Minimum array length: 1

Show child attributes

prompt

string

required

The instruction sent to the coding agent when the automation fires

environment_id

string<uuid>

required

ID of the environment this automation runs in. Required. The environment supplies the repository (or repository set) and resolved env vars / MCPs / skills.

description

string

Optional description

scope

enum<string>

default:org

Automation scope. org (default) creates an org-owned automation visible to all members. user creates a personal automation scoped to the authenticated user.

Available options:

org,

user

debounce_seconds

integer | null

Optional per-automation debounce window in seconds. When greater than 0, bursty trigger events update one pending run and the latest payload runs after matching events stop for this many seconds. GitHub and GitLab events keep separate pending runs per repository and pull or merge request. Null or 0 disables debouncing.

Required range: 0 <= x <= 86400

github_check_names

string[]

Optional GitHub check names this automation reports its verdict on. Requires a pull_request.opened or pull_request.synchronize trigger. Each name is created as an in-progress check run on the head commit of every matching pull request before the run is dispatched, so a required check cannot pass until the agent reports a result. Defaults to an empty array.

Maximum array length: 10

Maximum string length: 100

enabled

boolean

default:true

Whether the automation should be active (defaults to true)

workspace_lifecycle_policy

enum<string>

Lifecycle policy for workspaces created by this automation

Available options:

default,

archive_when_done,

sleep_when_done

workspace_auto_stop_minutes

integer

Inactivity timeout in minutes for the default keep-alive policy

Required range: 3 <= x <= 1440

workspace_size

enum<string>

default:small

Compute size for every workspace this automation fires off. small (2 vCPU, 8 GB memory, 20 GB disk) bills at $0.008/min; large (4 vCPU, 16 GB memory, 32 GB disk) bills at $0.016/min. Defaults to small.

Available options:

small,

large

config

object

Workspace behavior configuration. Missing capabilities and preferences default to disabled.

Show child attributes

agent_provider

enum<string> | null

Coding agent override. Null inherits the organization default.

Available options:

claude,

codex,

cursor,

opencode,

pi,

null

model

string | null

Model override. Requires agent_provider when set.

thinking_level

enum<string> | null

Thinking/reasoning level override. ultra is Codex-only; ultracode is Claude Code-only.

Available options:

low,

medium,

high,

xhigh,

max,

ultra,

ultracode,

null

plan_mode

boolean

Run automation messages in plan mode.

goal_mode

boolean | null

Set automation messages as Codex goals. Null inherits the resolved agent default; false explicitly disables it. Only applies when the resolved agent is Codex.

fast_mode

boolean | null

Run automation messages in fast mode. Null inherits the resolved agent default; false explicitly disables it.

Response

Automation created successfully

Response containing a single automation

automation

object

required

An automation record

Show child attributes

Replica

Presence

Credentials

Agents

Downloads

Media

Analytics

Environments

Repository

Automation

Google Search Console

Slack

Linear

Preview

Terminal

Profile

API Keys

Create Automation

Authorizations

Body

Response