Skip to main content
PATCH
Update automation

Authorizations

Authorization
string
header
required

Organization or personal API key from Settings → API Keys.

Headers

X-Replicas-Api-Version
enum<string>

API version. 2026-10-07 returns snake_case responses. See versioning.

Available options:
2026-10-07

Path Parameters

id
string<uuid>
required

The unique identifier of the automation

Body

application/json

Request body for updating an automation. Only provided fields are updated.

name
string

New name

description
string

New description

triggers
object[]

Replaces all triggers. At most one cron trigger and one trigger per event.

prompt
string

New prompt

debounce_seconds
integer | null

Seconds to wait for trigger events to stop before running once with the latest payload. GitHub and GitLab events debounce per pull or merge request. null or 0 disables debouncing.

Required range: 0 <= x <= 86400
github_check_names
string[]

Set or clear the GitHub check names this automation reports its verdict on. A non-empty list requires a pull_request.opened or pull_request.synchronize trigger. Pass an empty array to stop creating checks.

Maximum array length: 10
Maximum string length: 100
environment_id
string<uuid>

Move this automation to a different environment.

enabled
boolean

Enable or disable the automation

workspace_lifecycle_policy
enum<string>

New lifecycle policy

Available options:
default,
archive_when_done,
sleep_when_done
workspace_auto_stop_minutes
integer | null

New inactivity timeout in minutes for the default keep-alive policy (set to null to clear)

Required range: 3 <= x <= 1440
workspace_size
enum<string>

New compute size for every workspace this automation fires off. small (2 vCPU, 8 GB memory) bills at $0.008/min, large (4 vCPU, 16 GB memory) at $0.016/min, and ultra (8 vCPU, 32 GB memory) at $0.032/min.

Available options:
small,
large,
ultra
config
object

Workspace behavior configuration. Defaults depend on the workspace source; see each setting.

agent_provider
enum<string> | null

New coding agent override. Null inherits the organization default.

Available options:
claude,
codex,
cursor,
muse,
opencode,
pi,
null
model
string | null

New model override. Requires agent_provider when set. Must be a model your organization allows for that agent; hidden models are rejected with 400.

thinking_level
enum<string> | null

New thinking/reasoning level override. ultra is available for Codex and Muse Code; ultracode is Claude Code-only.

Available options:
low,
medium,
high,
xhigh,
max,
ultra,
ultracode,
null
plan_mode
boolean

Enable or disable plan mode for automation messages.

goal_mode
boolean | null

Enable or disable goal mode for automation messages. Null inherits the resolved agent default; false explicitly disables it.

fast_mode
boolean | null

Enable or disable fast mode for automation messages. Null inherits the resolved agent default; false explicitly disables it.

Response

Automation updated successfully

Response containing a single automation

automation
object
required

An automation record