Update an automation

curl --request PATCH \
  --url https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "instructions": "<string>",
  "model": "<string>",
  "tools": {
    "mcp_servers": [
      "<string>"
    ],
    "app_tools": [
      "<string>"
    ]
  },
  "enabled": true
}
'

import requests

url = "https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}"

payload = {
    "name": "<string>",
    "instructions": "<string>",
    "model": "<string>",
    "tools": {
        "mcp_servers": ["<string>"],
        "app_tools": ["<string>"]
    },
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    instructions: '<string>',
    model: '<string>',
    tools: {mcp_servers: ['<string>'], app_tools: ['<string>']},
    enabled: true
  })
};

fetch('https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}', 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.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'instructions' => '<string>',
    'model' => '<string>',
    'tools' => [
        'mcp_servers' => [
                '<string>'
        ],
        'app_tools' => [
                '<string>'
        ]
    ],
    'enabled' => 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.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"instructions\": \"<string>\",\n  \"model\": \"<string>\",\n  \"tools\": {\n    \"mcp_servers\": [\n      \"<string>\"\n    ],\n    \"app_tools\": [\n      \"<string>\"\n    ]\n  },\n  \"enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"instructions\": \"<string>\",\n  \"model\": \"<string>\",\n  \"tools\": {\n    \"mcp_servers\": [\n      \"<string>\"\n    ],\n    \"app_tools\": [\n      \"<string>\"\n    ]\n  },\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"instructions\": \"<string>\",\n  \"model\": \"<string>\",\n  \"tools\": {\n    \"mcp_servers\": [\n      \"<string>\"\n    ],\n    \"app_tools\": [\n      \"<string>\"\n    ]\n  },\n  \"enabled\": true\n}"

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

{
  "id": "automation_example",
  "org_id": "org_example",
  "name": "Daily repository review",
  "instructions": "Review open issues.",
  "model": null,
  "enabled": true,
  "tools": {
    "mcp_servers": null,
    "app_tools": []
  },
  "environment": {
    "repo": "example/project",
    "provider": "github"
  },
  "triggers": [
    {
      "id": "trigger_example",
      "kind": "schedule",
      "enabled": true,
      "schedule": {
        "kind": "cron",
        "expression": "0 9 * * *",
        "every_seconds": null,
        "next_run_at": "2026-09-24T09:00:00Z"
      },
      "github": null,
      "webhook": null,
      "run_kind": null,
      "last_fired_at": null,
      "created_at": "2026-09-01T00:00:00Z",
      "updated_at": "2026-09-01T00:00:00Z"
    }
  ],
  "created_at": "2026-09-01T00:00:00Z",
  "updated_at": "2026-09-01T00:00:00Z"
}

{
  "error": "prompt_required"
}

{
  "error": "missing_bearer",
  "message": "Authorization required"
}

{
  "error": "missing_scope",
  "required_scope": "sessions:read"
}

{
  "error": "session_not_found"
}

{
  "error": {
    "type": "rate_limited",
    "message": "This API key exceeded its request-rate limit"
  }
}

Automations

Update an automation

Partial update of the automation’s configuration. Send only the fields you want to change. The same name, instructions and tools rules as create apply to the fields you send. Triggers are managed through the triggers sub-resource. Only the automation’s creator can change it; workspace owners and admins can pause or delete it. Anyone else receives 403 automation_owner_only. A system automation (include=system) is changed only by workspace owners and admins (403 workspace_agent_admin_only); any member may add a trigger to it, which runs as that member, and remove their own triggers.

_{Scope: automations:write}

PATCH

organizations

{orgId}

automations

{automationId}

Update an automation

curl --request PATCH \
  --url https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "instructions": "<string>",
  "model": "<string>",
  "tools": {
    "mcp_servers": [
      "<string>"
    ],
    "app_tools": [
      "<string>"
    ]
  },
  "enabled": true
}
'

import requests

url = "https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}"

payload = {
    "name": "<string>",
    "instructions": "<string>",
    "model": "<string>",
    "tools": {
        "mcp_servers": ["<string>"],
        "app_tools": ["<string>"]
    },
    "enabled": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    instructions: '<string>',
    model: '<string>',
    tools: {mcp_servers: ['<string>'], app_tools: ['<string>']},
    enabled: true
  })
};

fetch('https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}', 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.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'instructions' => '<string>',
    'model' => '<string>',
    'tools' => [
        'mcp_servers' => [
                '<string>'
        ],
        'app_tools' => [
                '<string>'
        ]
    ],
    'enabled' => 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.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"instructions\": \"<string>\",\n  \"model\": \"<string>\",\n  \"tools\": {\n    \"mcp_servers\": [\n      \"<string>\"\n    ],\n    \"app_tools\": [\n      \"<string>\"\n    ]\n  },\n  \"enabled\": true\n}")

	req, _ := http.NewRequest("PATCH", 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.patch("https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"instructions\": \"<string>\",\n  \"model\": \"<string>\",\n  \"tools\": {\n    \"mcp_servers\": [\n      \"<string>\"\n    ],\n    \"app_tools\": [\n      \"<string>\"\n    ]\n  },\n  \"enabled\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.reasonmachines.com/v3/organizations/{orgId}/automations/{automationId}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"instructions\": \"<string>\",\n  \"model\": \"<string>\",\n  \"tools\": {\n    \"mcp_servers\": [\n      \"<string>\"\n    ],\n    \"app_tools\": [\n      \"<string>\"\n    ]\n  },\n  \"enabled\": true\n}"

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

{
  "id": "automation_example",
  "org_id": "org_example",
  "name": "Daily repository review",
  "instructions": "Review open issues.",
  "model": null,
  "enabled": true,
  "tools": {
    "mcp_servers": null,
    "app_tools": []
  },
  "environment": {
    "repo": "example/project",
    "provider": "github"
  },
  "triggers": [
    {
      "id": "trigger_example",
      "kind": "schedule",
      "enabled": true,
      "schedule": {
        "kind": "cron",
        "expression": "0 9 * * *",
        "every_seconds": null,
        "next_run_at": "2026-09-24T09:00:00Z"
      },
      "github": null,
      "webhook": null,
      "run_kind": null,
      "last_fired_at": null,
      "created_at": "2026-09-01T00:00:00Z",
      "updated_at": "2026-09-01T00:00:00Z"
    }
  ],
  "created_at": "2026-09-01T00:00:00Z",
  "updated_at": "2026-09-01T00:00:00Z"
}

{
  "error": "prompt_required"
}

{
  "error": "missing_bearer",
  "message": "Authorization required"
}

{
  "error": "missing_scope",
  "required_scope": "sessions:read"
}

{
  "error": "session_not_found"
}

{
  "error": {
    "type": "rate_limited",
    "message": "This API key exceeded its request-rate limit"
  }
}

Authorizations

Authorization

string

header

required

Your Reason API key from Settings > API. New keys use reason_; legacy ara_ keys remain accepted. Keys are capability-scoped: run, mcp:read, mcp:write, secrets:read, secrets:write, sessions:read, sessions:debug, knowledge:read, memory:read, memory:write, skills:read, skills:write, repos:read, repos:write, reviews:read, reviews:write, deployment:read, analytics:read, org:read, org:write, attachments:read, attachments:write, guardrails:read, guardrails:write, automations:read, automations:write, agent_auth:read. mcp:write manages MCP server configuration only; it does not authorize remote MCP-tool execution. sessions:read reads sessions, including the assistant, reasoning and tool activity in their events. sessions:debug is privileged: only for organization owners/admins, it expands session events to the full diagnostic projection (diagnostic event kinds, status text and raw event metadata).

Path Parameters

orgId

string

required

Organization id or slug. Resolve it with GET /v3/self.

automationId

string

required

Body

application/json

All fields optional. Only the fields you send are changed.

name

string

Display name, trimmed, at most 200 characters. Blank returns 400 name_required.

instructions

string

Trimmed, at most 100,000 characters. Blank returns 400 instructions_required.

model

string | null

tools

object

Show child attributes

enabled

boolean

Set false to pause the automation. A paused automation's triggers never fire.

Response

Updated.

An automation: its instructions, tools, environment binding, and triggers.

string

org_id

string

name

string | null

instructions

string | null

The system instructions the automation runs with.

model

string | null

enabled

boolean

A paused (false) automation's triggers never fire.

tools

object

Show child attributes

environment

object

Show child attributes

triggers

object[]

Every condition that fires this automation. Empty until you add one.

Show child attributes

warnings

object[]

Present only when the request was accepted but something is not as sent or not usable yet. Codes: schedule_interval_raised, app_tool_not_connected.

Show child attributes

created_at

string<date-time>

updated_at

string<date-time>