Sign in
latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-14409129967.7 KB

95679a9aa625

Task Automations

Update an existing automation

Update an existing automation in Betayum. Create, version, run, and inspect automated evidence collection workflows attached to compliance tasks.

patch/v1/tasks/{taskId}/automations/{automationId}

Path parameters

taskIdstring required
Example:tsk_abc123def456

Unique task identifier

automationIdstring required
Example:auto_abc123def456

Unique automation identifier

Request body

namestring

Automation name

descriptionstring

Automation description

isEnabledboolean

Whether the automation is enabled

evaluationCriteriastring

Evaluation criteria for the automation

scheduleFrequency'daily' | 'weekly' | 'monthly' | 'quarterly' | 'yearly'

Automation schedule cadence

allowedToolsstring[]

Tool names the AI may use during chat (e.g. promptForSecret, promptForInfo). Null means all tools are allowed.

setupStatus'building' | 'ready' | 'action_needed' | 'failed'

Current state of automated setup performed by the AI queue

setupTaskobject nullable

Specific information or intervention required from the user to continue setup

Example request

{
  "name": "GitHub Security Check - Evidence Collection",
  "description": "Collects evidence about GitHub repository security settings",
  "allowedTools": [
    "promptForSecret",
    "promptForInfo"
  ]
}

Response

Automation updated successfully

successboolean

Example response

{
  "success": true,
  "automation": {
    "id": "auto_abc123def456",
    "name": "Updated Automation Name",
    "description": "Updated description"
  }
}