curl --request PUT \
--url https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"auto_fix_new_issues": true,
"auto_audit_on_connect": true,
"pr_risk_assessment": true,
"auto_merge_prs": true,
"auto_merge_require_no_blocking_findings": true,
"auto_merge_require_reason_authored": true,
"auto_merge_require_ci_green": true,
"auto_merge_require_reason_verify": true,
"auto_merge_require_migration_approval": true,
"auto_merge_require_ara_authored": true,
"auto_merge_require_ara_verify": true,
"auto_merge_custom_prompt": "<string>",
"auto_merge_protected_paths": "<string>",
"auto_merge_max_changed_lines": 1,
"auto_merge_delete_branch": true,
"autofix_prs": true,
"browser_enabled": true,
"allow_install_scripts": true
}
'import requests
url = "https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails"
payload = {
"auto_fix_new_issues": True,
"auto_audit_on_connect": True,
"pr_risk_assessment": True,
"auto_merge_prs": True,
"auto_merge_require_no_blocking_findings": True,
"auto_merge_require_reason_authored": True,
"auto_merge_require_ci_green": True,
"auto_merge_require_reason_verify": True,
"auto_merge_require_migration_approval": True,
"auto_merge_require_ara_authored": True,
"auto_merge_require_ara_verify": True,
"auto_merge_custom_prompt": "<string>",
"auto_merge_protected_paths": "<string>",
"auto_merge_max_changed_lines": 1,
"auto_merge_delete_branch": True,
"autofix_prs": True,
"browser_enabled": True,
"allow_install_scripts": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
auto_fix_new_issues: true,
auto_audit_on_connect: true,
pr_risk_assessment: true,
auto_merge_prs: true,
auto_merge_require_no_blocking_findings: true,
auto_merge_require_reason_authored: true,
auto_merge_require_ci_green: true,
auto_merge_require_reason_verify: true,
auto_merge_require_migration_approval: true,
auto_merge_require_ara_authored: true,
auto_merge_require_ara_verify: true,
auto_merge_custom_prompt: '<string>',
auto_merge_protected_paths: '<string>',
auto_merge_max_changed_lines: 1,
auto_merge_delete_branch: true,
autofix_prs: true,
browser_enabled: true,
allow_install_scripts: true
})
};
fetch('https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails', 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}/repositories/{owner}/{repo}/guardrails",
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([
'auto_fix_new_issues' => true,
'auto_audit_on_connect' => true,
'pr_risk_assessment' => true,
'auto_merge_prs' => true,
'auto_merge_require_no_blocking_findings' => true,
'auto_merge_require_reason_authored' => true,
'auto_merge_require_ci_green' => true,
'auto_merge_require_reason_verify' => true,
'auto_merge_require_migration_approval' => true,
'auto_merge_require_ara_authored' => true,
'auto_merge_require_ara_verify' => true,
'auto_merge_custom_prompt' => '<string>',
'auto_merge_protected_paths' => '<string>',
'auto_merge_max_changed_lines' => 1,
'auto_merge_delete_branch' => true,
'autofix_prs' => true,
'browser_enabled' => true,
'allow_install_scripts' => 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}/repositories/{owner}/{repo}/guardrails"
payload := strings.NewReader("{\n \"auto_fix_new_issues\": true,\n \"auto_audit_on_connect\": true,\n \"pr_risk_assessment\": true,\n \"auto_merge_prs\": true,\n \"auto_merge_require_no_blocking_findings\": true,\n \"auto_merge_require_reason_authored\": true,\n \"auto_merge_require_ci_green\": true,\n \"auto_merge_require_reason_verify\": true,\n \"auto_merge_require_migration_approval\": true,\n \"auto_merge_require_ara_authored\": true,\n \"auto_merge_require_ara_verify\": true,\n \"auto_merge_custom_prompt\": \"<string>\",\n \"auto_merge_protected_paths\": \"<string>\",\n \"auto_merge_max_changed_lines\": 1,\n \"auto_merge_delete_branch\": true,\n \"autofix_prs\": true,\n \"browser_enabled\": true,\n \"allow_install_scripts\": true\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"auto_fix_new_issues\": true,\n \"auto_audit_on_connect\": true,\n \"pr_risk_assessment\": true,\n \"auto_merge_prs\": true,\n \"auto_merge_require_no_blocking_findings\": true,\n \"auto_merge_require_reason_authored\": true,\n \"auto_merge_require_ci_green\": true,\n \"auto_merge_require_reason_verify\": true,\n \"auto_merge_require_migration_approval\": true,\n \"auto_merge_require_ara_authored\": true,\n \"auto_merge_require_ara_verify\": true,\n \"auto_merge_custom_prompt\": \"<string>\",\n \"auto_merge_protected_paths\": \"<string>\",\n \"auto_merge_max_changed_lines\": 1,\n \"auto_merge_delete_branch\": true,\n \"autofix_prs\": true,\n \"browser_enabled\": true,\n \"allow_install_scripts\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"auto_fix_new_issues\": true,\n \"auto_audit_on_connect\": true,\n \"pr_risk_assessment\": true,\n \"auto_merge_prs\": true,\n \"auto_merge_require_no_blocking_findings\": true,\n \"auto_merge_require_reason_authored\": true,\n \"auto_merge_require_ci_green\": true,\n \"auto_merge_require_reason_verify\": true,\n \"auto_merge_require_migration_approval\": true,\n \"auto_merge_require_ara_authored\": true,\n \"auto_merge_require_ara_verify\": true,\n \"auto_merge_custom_prompt\": \"<string>\",\n \"auto_merge_protected_paths\": \"<string>\",\n \"auto_merge_max_changed_lines\": 1,\n \"auto_merge_delete_branch\": true,\n \"autofix_prs\": true,\n \"browser_enabled\": true,\n \"allow_install_scripts\": true\n}"
response = http.request(request)
puts response.read_body{
"repo": "<string>",
"guardrails": {
"auto_fix_new_issues": true,
"auto_audit_on_connect": true,
"pr_risk_assessment": true,
"auto_merge_prs": true,
"auto_merge_max_risk": "zero",
"auto_merge_require_no_blocking_findings": true,
"auto_merge_require_reason_authored": true,
"auto_merge_require_ci_green": true,
"auto_merge_require_reason_verify": true,
"auto_merge_require_migration_approval": true,
"auto_merge_require_ara_authored": true,
"auto_merge_require_ara_verify": true,
"auto_merge_review_context": "all_review_bots",
"auto_merge_custom_prompt": "<string>",
"auto_merge_protected_paths": "<string>",
"auto_merge_max_changed_lines": 1,
"auto_merge_delete_branch": true,
"autofix_prs": true,
"browser_enabled": true,
"allow_install_scripts": true
},
"provider": "github"
}{
"error": "prompt_required"
}{
"error": "missing_bearer",
"message": "Authorization required"
}{
"error": "missing_scope",
"required_scope": "sessions:read"
}{
"error": {
"type": "rate_limited",
"message": "This API key exceeded its request-rate limit"
}
}Update repository guardrails
Partial update. Send only the guardrail fields you want to change.
Scope:guardrails:writecurl --request PUT \
--url https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"auto_fix_new_issues": true,
"auto_audit_on_connect": true,
"pr_risk_assessment": true,
"auto_merge_prs": true,
"auto_merge_require_no_blocking_findings": true,
"auto_merge_require_reason_authored": true,
"auto_merge_require_ci_green": true,
"auto_merge_require_reason_verify": true,
"auto_merge_require_migration_approval": true,
"auto_merge_require_ara_authored": true,
"auto_merge_require_ara_verify": true,
"auto_merge_custom_prompt": "<string>",
"auto_merge_protected_paths": "<string>",
"auto_merge_max_changed_lines": 1,
"auto_merge_delete_branch": true,
"autofix_prs": true,
"browser_enabled": true,
"allow_install_scripts": true
}
'import requests
url = "https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails"
payload = {
"auto_fix_new_issues": True,
"auto_audit_on_connect": True,
"pr_risk_assessment": True,
"auto_merge_prs": True,
"auto_merge_require_no_blocking_findings": True,
"auto_merge_require_reason_authored": True,
"auto_merge_require_ci_green": True,
"auto_merge_require_reason_verify": True,
"auto_merge_require_migration_approval": True,
"auto_merge_require_ara_authored": True,
"auto_merge_require_ara_verify": True,
"auto_merge_custom_prompt": "<string>",
"auto_merge_protected_paths": "<string>",
"auto_merge_max_changed_lines": 1,
"auto_merge_delete_branch": True,
"autofix_prs": True,
"browser_enabled": True,
"allow_install_scripts": True
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
auto_fix_new_issues: true,
auto_audit_on_connect: true,
pr_risk_assessment: true,
auto_merge_prs: true,
auto_merge_require_no_blocking_findings: true,
auto_merge_require_reason_authored: true,
auto_merge_require_ci_green: true,
auto_merge_require_reason_verify: true,
auto_merge_require_migration_approval: true,
auto_merge_require_ara_authored: true,
auto_merge_require_ara_verify: true,
auto_merge_custom_prompt: '<string>',
auto_merge_protected_paths: '<string>',
auto_merge_max_changed_lines: 1,
auto_merge_delete_branch: true,
autofix_prs: true,
browser_enabled: true,
allow_install_scripts: true
})
};
fetch('https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails', 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}/repositories/{owner}/{repo}/guardrails",
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([
'auto_fix_new_issues' => true,
'auto_audit_on_connect' => true,
'pr_risk_assessment' => true,
'auto_merge_prs' => true,
'auto_merge_require_no_blocking_findings' => true,
'auto_merge_require_reason_authored' => true,
'auto_merge_require_ci_green' => true,
'auto_merge_require_reason_verify' => true,
'auto_merge_require_migration_approval' => true,
'auto_merge_require_ara_authored' => true,
'auto_merge_require_ara_verify' => true,
'auto_merge_custom_prompt' => '<string>',
'auto_merge_protected_paths' => '<string>',
'auto_merge_max_changed_lines' => 1,
'auto_merge_delete_branch' => true,
'autofix_prs' => true,
'browser_enabled' => true,
'allow_install_scripts' => 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}/repositories/{owner}/{repo}/guardrails"
payload := strings.NewReader("{\n \"auto_fix_new_issues\": true,\n \"auto_audit_on_connect\": true,\n \"pr_risk_assessment\": true,\n \"auto_merge_prs\": true,\n \"auto_merge_require_no_blocking_findings\": true,\n \"auto_merge_require_reason_authored\": true,\n \"auto_merge_require_ci_green\": true,\n \"auto_merge_require_reason_verify\": true,\n \"auto_merge_require_migration_approval\": true,\n \"auto_merge_require_ara_authored\": true,\n \"auto_merge_require_ara_verify\": true,\n \"auto_merge_custom_prompt\": \"<string>\",\n \"auto_merge_protected_paths\": \"<string>\",\n \"auto_merge_max_changed_lines\": 1,\n \"auto_merge_delete_branch\": true,\n \"autofix_prs\": true,\n \"browser_enabled\": true,\n \"allow_install_scripts\": true\n}")
req, _ := http.NewRequest("PUT", 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.put("https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"auto_fix_new_issues\": true,\n \"auto_audit_on_connect\": true,\n \"pr_risk_assessment\": true,\n \"auto_merge_prs\": true,\n \"auto_merge_require_no_blocking_findings\": true,\n \"auto_merge_require_reason_authored\": true,\n \"auto_merge_require_ci_green\": true,\n \"auto_merge_require_reason_verify\": true,\n \"auto_merge_require_migration_approval\": true,\n \"auto_merge_require_ara_authored\": true,\n \"auto_merge_require_ara_verify\": true,\n \"auto_merge_custom_prompt\": \"<string>\",\n \"auto_merge_protected_paths\": \"<string>\",\n \"auto_merge_max_changed_lines\": 1,\n \"auto_merge_delete_branch\": true,\n \"autofix_prs\": true,\n \"browser_enabled\": true,\n \"allow_install_scripts\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.reasonmachines.com/v3/organizations/{orgId}/repositories/{owner}/{repo}/guardrails")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"auto_fix_new_issues\": true,\n \"auto_audit_on_connect\": true,\n \"pr_risk_assessment\": true,\n \"auto_merge_prs\": true,\n \"auto_merge_require_no_blocking_findings\": true,\n \"auto_merge_require_reason_authored\": true,\n \"auto_merge_require_ci_green\": true,\n \"auto_merge_require_reason_verify\": true,\n \"auto_merge_require_migration_approval\": true,\n \"auto_merge_require_ara_authored\": true,\n \"auto_merge_require_ara_verify\": true,\n \"auto_merge_custom_prompt\": \"<string>\",\n \"auto_merge_protected_paths\": \"<string>\",\n \"auto_merge_max_changed_lines\": 1,\n \"auto_merge_delete_branch\": true,\n \"autofix_prs\": true,\n \"browser_enabled\": true,\n \"allow_install_scripts\": true\n}"
response = http.request(request)
puts response.read_body{
"repo": "<string>",
"guardrails": {
"auto_fix_new_issues": true,
"auto_audit_on_connect": true,
"pr_risk_assessment": true,
"auto_merge_prs": true,
"auto_merge_max_risk": "zero",
"auto_merge_require_no_blocking_findings": true,
"auto_merge_require_reason_authored": true,
"auto_merge_require_ci_green": true,
"auto_merge_require_reason_verify": true,
"auto_merge_require_migration_approval": true,
"auto_merge_require_ara_authored": true,
"auto_merge_require_ara_verify": true,
"auto_merge_review_context": "all_review_bots",
"auto_merge_custom_prompt": "<string>",
"auto_merge_protected_paths": "<string>",
"auto_merge_max_changed_lines": 1,
"auto_merge_delete_branch": true,
"autofix_prs": true,
"browser_enabled": true,
"allow_install_scripts": true
},
"provider": "github"
}{
"error": "prompt_required"
}{
"error": "missing_bearer",
"message": "Authorization required"
}{
"error": "missing_scope",
"required_scope": "sessions:read"
}{
"error": {
"type": "rate_limited",
"message": "This API key exceeded its request-rate limit"
}
}Authorizations
Your Reason API key from Settings › API keys. 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, devices:read, devices:write, devices:use, computers:read, computers:write, ssh:write, knowledge:read, memory:read, memory:write, skills:read, skills:write, pages:read, pages: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, network:read, network:write, automations:read, automations:write, agent_auth:read. devices:write, devices:use, computers:read, computers:write, ssh:write, network:read and network:write are opt-in, excluded from default keys. computers:read lists visible cloud and connected computers without waking them or granting execution access. devices:read discovers local Device targets; devices:use separately consents to local execution, so a discover-and-run local workflow needs both. devices:write manages enrollment and device grants; computers:write creates or deletes cloud computers; ssh:write manages retained SSH access. network:read reads the saved workspace network policy; network:write replaces custom allowed hosts and requires a current organization owner/admin. Legacy project PATCH requests containing network_allowed_hosts also require network:write plus their existing run scope and project management permission; saved project hosts do not affect current session egress. Only owners/admins can mint or manage keys with network:write; keys cannot grant themselves more authority. See /docs/network-policies for replacement semantics and runtime applicability. 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
Query Parameters
Body
A repository's automation guardrails. In a response, its effective values: stored ones, with defaults for any never set. In an update, every property is optional and only the fields sent change.
Which automated review-bot comments PR Merge Bot reads. ara_review_bot_only is a deprecated spelling of reason_review_bot_only, still accepted on update; responses report reason_review_bot_only.
all_review_bots, reason_review_bot_only, ara_review_bot_only Fix failing CI on pull requests agents open: when a check on one fails or times out, Reason sends an automatic follow-up to fix its branch, by default at most one attempt per pull request. It continues the Session that opened the pull request while that Session is open, otherwise it runs in its own Automation Session. Reviews do not trigger it. Reason may post comments and push commits.
Response
The updated repository guardrails.

