CreateTaskRequest

Request body for POST /tasks.

intent, entity_scope, and delivery are required. constraints is optional — when absent, the LLM uses guardrail defaults. dry_run=True returns a DryRunResult (see models/result.py) without persisting the task.

intentIntent (string)required

entity_scopeEntity Scope (string)required

delivery objectrequired

Describes how a triggered condition delivers its alert.

Validation rules (enforced at model construction time): webhook → endpoint is required notification → channel is required email → channel is required workflow → workflow_id is required

typeDeliveryType (string)required

Possible values: [webhook, notification, email, workflow]

endpoint object

anyOf

• string
• null

string

channel object

anyOf

• string
• null

string

workflow_id object

anyOf

• string
• null

string

constraints object

anyOf

• ConstraintsConfig
• null

sensitivity object

anyOf

• Sensitivity
• null

Sensitivity (string)

Hint to the LLM for threshold prior selection (used in ConstraintsConfig).

Possible values: [low, medium, high]

namespace object

anyOf

• Namespace
• null

Namespace (string)

Possible values: [personal, team, org, global]

dry_runDry Run (boolean)

Default value: false

CreateTaskRequest

{
  "intent": "string",
  "entity_scope": "string",
  "delivery": {
    "type": "webhook",
    "endpoint": "string",
    "channel": "string",
    "workflow_id": "string"
  },
  "constraints": {
    "sensitivity": "low",
    "namespace": "personal"
  },
  "dry_run": false
}