REreplicas
Automations

Update automation

Updates only the fields you send. triggers replaces all triggers.

patch/v1/automations/{id}

Request

  • Base URL
    https://api.replicas.dev
  • URL
    https://api.replicas.dev/v1/automations/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The unique identifier of the automation

Headers

X-Replicas-Api-Version'2026-10-07'

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

Request body

namestring

New name

descriptionstring

New description

promptstring

New prompt

debounce_secondsinteger nullable

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.

github_check_namesstring[]

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.

environment_idstring uuid

Move this automation to a different environment.

enabledboolean

Enable or disable the automation

workspace_lifecycle_policy'default' | 'archive_when_done' | 'sleep_when_done' | 'delete_when_done'

New lifecycle policy

workspace_auto_stop_minutesinteger nullable

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

workspace_size'small' | 'large' | 'ultra'

New compute size for every workspace this automation fires off. small (2 vCPU, 8 GB memory), large (4 vCPU, 16 GB memory), or ultra (8 vCPU, 32 GB memory); see Billing for per-size rates.

agent_provider'claude' | 'codex' | 'cursor' | 'muse' | 'opencode' | 'pi' | 'null' nullable

New coding agent override. Null inherits the organization default.

modelstring nullable

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'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra' | 'ultracode' | 'null' nullable

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

plan_modeboolean

Enable or disable plan mode for automation messages.

goal_modeboolean nullable

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

fast_modeboolean nullable

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

scope'org'

Set to org to move a personal automation to the organization so teammates can see and edit it. Requires a shared environment and Automations write access. Cannot be undone.

Example request

{
  "triggers": [
    {
      "config": {
        "schedule": "0 9 * * 1-5",
        "timezone": "America/New_York"
      }
    }
  ]
}

Response

Automation updated successfully

Example response

{
  "automation": {
    "triggers": [
      {
        "config": {
          "schedule": "0 9 * * 1-5",
          "timezone": "America/New_York"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.