Automations

Create an automation

Creates the automation's configuration (instructions + an optional repository). Add a trigger with POST /automations/{automationId}/triggers to make it fire. A repo, when sent, must already be connected (400 repo_not_connected); without one the automation's runs start with no repository checked out. It is created enabled unless enabled: false is sent; a paused automation's triggers do not fire until it is enabled with an update. Name and instructions are trimmed and may not be blank; tools must name MCP servers the workspace has and known app tools (see the field descriptions for each 400 code). A known app tool that is not connected yet is accepted with an app_tool_not_connected entry in warnings.

<sub>Scope: automations:write</sub>

post/v3/organizations/{orgId}/automations

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/automations
  • Auth: HTTP bearer

Request body

namestring

Display name, trimmed, at most 200 characters. Defaults to the start of instructions when omitted. A blank name returns 400 name_required; a longer one returns 400 name_too_long.

instructionsstring required

The system instructions the automation runs with, trimmed, at most 100,000 characters. Blank instructions return 400 instructions_required; longer ones return 400 instructions_too_long.

repostring

Connected GitHub repository path in owner/name form. Omit it for an automation that is not bound to a repository: its runs start with no repository checked out. A blank value returns 400 repo_required; one that is not connected returns 400 repo_not_connected.

provider'github'

Source-control provider for the connected repository. GitHub is the only supported provider. Sending it without repo returns 400 repo_required.

modelstring nullable

Model override. null uses the workspace default. New runs accept only the currently available Reason model catalog.

enabledboolean

Whether the automation starts active. Send false to create it paused: its triggers never fire until an update sets enabled: true.

Response

Created.

idstring
org_idstring
namestring nullable
instructionsstring nullable

The system instructions the automation runs with.

modelstring nullable
enabledboolean

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

created_atstring date-time
updated_atstring date-time

Changes

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