Skip to content
Micro micro
Go to Micro
API Reference
Triggered Automations

Replace a triggered automation (idempotent full write of the whole tree)

client.triggeredAutomations.update(stringautomationID, TriggeredAutomationUpdateParams { teamId, automationObjectType, kind, 14 more } params, RequestOptionsoptions?): TriggeredAutomation { kind, name, id, 11 more }
PUT/v2/prism/{teamId}/{automationObjectType}/triggered_automations/{automationId}

Replace a triggered automation (idempotent full write of the whole tree)

ParametersExpand Collapse
automationID: string
formatuuid
params: TriggeredAutomationUpdateParams { teamId, automationObjectType, kind, 14 more }
teamId?: string

Path param

formatuuid
automationObjectType: "message" | "action" | "event" | 6 more

Path param: Object types that support triggered automations. Must match the triggered-automation whitelist in @micro/database migrate-sql (TRIGGERED_AUTOMATION_OBJECTS).

One of the following:
"message"
"action"
"event"
"document"
"identity"
"linkedin_message"
"deal"
"organization"
"contact"
kind: "update" | "lifecycle"

Body param

One of the following:
"update"
"lifecycle"
name: string

Body param

id?: string

Body param

formatuuid
actions?: Array<Action>

Body param: Actions to run when the automation fires; each item has a type plus type-specific fields.

type: "agent" | "webhook" | "wait" | 2 more
One of the following:
"agent"
"webhook"
"wait"
"email"
"linkedin"
agent_id?: string | null

Required when type is agent. The agent to run.

formatuuid
cron_expression?: string | null

wait: cron schedule for the resume time. Exactly one of delay_seconds or cron_expression.

delay_seconds?: number | null

wait: relative delay in seconds. Exactly one of delay_seconds or cron_expression.

recipient_email_prop_def_id?: string | null

Required when type is email. The property (on the recipient view object) holding the recipient email address.

formatuuid
recipient_provider_prop_def_id?: string | null

Required when type is linkedin. The property (on the recipient view object) holding the recipient LinkedIn provider id.

formatuuid
recipient_view_id?: string | null

Required when type is email or linkedin. The saved prism view resolved at send time to the recipient audience (its filter re-runs each step, so responders drop out of later drip sends).

formatuuid
recipient_view_object_type?: string | null

Required when type is email or linkedin. Must be contact — the recipient audience is a contact view (contacts carry the direct email / linkedin provider property).

send_as_user_id?: string | null

Required when type is email or linkedin. The user (external id) the message is sent as.

subject?: string | null

Required when type is email. The subject line; rendered as a Liquid template per recipient.

template_id?: string | null

Required when type is email or linkedin. The email-template document whose body is rendered (Liquid) per recipient.

formatuuid
timezone?: string | null

wait: IANA timezone for evaluating cron_expression (optional).

webhook_id?: string | null

Required when type is webhook. The id of the webhook the event is dispatched to (async) when the automation fires.

formatuuid
changeset?: Changeset

Body param: A changeset filter group (update automations only): a combinator plus an array of transition clauses matching what is changing. Dot-paths (nested reference filters) are NOT permitted — direct properties only.

combinator?: "AND" | "OR"
One of the following:
"AND"
"OR"
filter?: Array<Record<string, unknown>>

Each entry is a transition clause { slug: { from?: { comparator: value }, to?: { comparator: value } } }. from matches the prior value, to the new value; an empty body { slug: {} } matches any change to that property.

created_at?: string

Body param

enabled?: boolean

Body param

list_id?: string | null

Body param

formatuuid
on_create?: boolean

Body param: Lifecycle automations only.

on_delete?: boolean

Body param: Lifecycle automations only.

state?: State

Body param: A filter group: a combinator plus an array of slug-based clauses. Dot-paths (e.g. organization.location) express nested reference filters.

combinator?: "AND" | "OR"
One of the following:
"AND"
"OR"
filter?: Array<Record<string, unknown>>

Each entry is { slug: { comparator: value } }

team_id?: string | null

Body param

formatuuid
updated_at?: string | null

Body param

user_id?: string | null

Body param

idempotencyKey?: string

Header param: A unique key (UUID or any opaque string up to 255 chars) for an authenticated POST, PUT, or PATCH request. The server retains the initial claim for 24 hours and replays a completed non-5xx response only when the method, path, and request body all match. Reusing a non-expired key with a different method, path, or body returns 409 idempotency_key_mismatch; reusing it after expiry returns 409 idempotency_key_stale, so use a new key. Replays include the idempotent-replay: true response header.

minLength1
maxLength255
ReturnsExpand Collapse
TriggeredAutomation { kind, name, id, 11 more }

A triggered automation. kind selects the shape: update fires on object updates and requires a changeset (from/to transition) filter plus an optional state precondition; lifecycle fires on create and/or delete (on_create/on_delete) and requires a state filter (no changeset). state permits dot-paths (nested reference filters); changeset is direct properties only. Object type is taken from the path.

kind: "update" | "lifecycle"
One of the following:
"update"
"lifecycle"
name: string
id?: string
formatuuid
actions?: Array<Action>

Actions to run when the automation fires; each item has a type plus type-specific fields.

type: "agent" | "webhook" | "wait" | 2 more
One of the following:
"agent"
"webhook"
"wait"
"email"
"linkedin"
agent_id?: string | null

Required when type is agent. The agent to run.

formatuuid
cron_expression?: string | null

wait: cron schedule for the resume time. Exactly one of delay_seconds or cron_expression.

delay_seconds?: number | null

wait: relative delay in seconds. Exactly one of delay_seconds or cron_expression.

recipient_email_prop_def_id?: string | null

Required when type is email. The property (on the recipient view object) holding the recipient email address.

formatuuid
recipient_provider_prop_def_id?: string | null

Required when type is linkedin. The property (on the recipient view object) holding the recipient LinkedIn provider id.

formatuuid
recipient_view_id?: string | null

Required when type is email or linkedin. The saved prism view resolved at send time to the recipient audience (its filter re-runs each step, so responders drop out of later drip sends).

formatuuid
recipient_view_object_type?: string | null

Required when type is email or linkedin. Must be contact — the recipient audience is a contact view (contacts carry the direct email / linkedin provider property).

send_as_user_id?: string | null

Required when type is email or linkedin. The user (external id) the message is sent as.

subject?: string | null

Required when type is email. The subject line; rendered as a Liquid template per recipient.

template_id?: string | null

Required when type is email or linkedin. The email-template document whose body is rendered (Liquid) per recipient.

formatuuid
timezone?: string | null

wait: IANA timezone for evaluating cron_expression (optional).

webhook_id?: string | null

Required when type is webhook. The id of the webhook the event is dispatched to (async) when the automation fires.

formatuuid
changeset?: Changeset { combinator, filter }

A changeset filter group (update automations only): a combinator plus an array of transition clauses matching what is changing. Dot-paths (nested reference filters) are NOT permitted — direct properties only.

combinator?: "AND" | "OR"
One of the following:
"AND"
"OR"
filter?: Array<Record<string, unknown>>

Each entry is a transition clause { slug: { from?: { comparator: value }, to?: { comparator: value } } }. from matches the prior value, to the new value; an empty body { slug: {} } matches any change to that property.

created_at?: string
enabled?: boolean
list_id?: string | null
formatuuid
on_create?: boolean

Lifecycle automations only.

on_delete?: boolean

Lifecycle automations only.

state?: State { combinator, filter }

A filter group: a combinator plus an array of slug-based clauses. Dot-paths (e.g. organization.location) express nested reference filters.

combinator?: "AND" | "OR"
One of the following:
"AND"
"OR"
filter?: Array<Record<string, unknown>>

Each entry is { slug: { comparator: value } }

team_id?: string | null
formatuuid
updated_at?: string | null
user_id?: string | null

Replace a triggered automation (idempotent full write of the whole tree)

import Micro from '@micro-so/sdk';

const client = new Micro({
  teamID: 'My Team ID',
  apiKey: process.env['MICRO_API_KEY'], // This is the default and can be omitted
});

const triggeredAutomation = await client.triggeredAutomations.update(
  '182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e',
  {
    automationObjectType: 'message',
    kind: 'update',
    name: 'name',
  },
);

console.log(triggeredAutomation.id);
{
  "kind": "update",
  "name": "name",
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "actions": [
    {
      "type": "agent",
      "agent_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "cron_expression": "cron_expression",
      "delay_seconds": 0,
      "recipient_email_prop_def_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "recipient_provider_prop_def_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "recipient_view_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "recipient_view_object_type": "recipient_view_object_type",
      "send_as_user_id": "send_as_user_id",
      "subject": "subject",
      "template_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "timezone": "timezone",
      "webhook_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
    }
  ],
  "changeset": {
    "combinator": "AND",
    "filter": [
      {
        "foo": "bar"
      }
    ]
  },
  "created_at": "created_at",
  "enabled": true,
  "list_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "on_create": true,
  "on_delete": true,
  "state": {
    "combinator": "AND",
    "filter": [
      {
        "foo": "bar"
      }
    ]
  },
  "team_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "updated_at": "updated_at",
  "user_id": "user_id"
}
Returns Examples
{
  "kind": "update",
  "name": "name",
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "actions": [
    {
      "type": "agent",
      "agent_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "cron_expression": "cron_expression",
      "delay_seconds": 0,
      "recipient_email_prop_def_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "recipient_provider_prop_def_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "recipient_view_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "recipient_view_object_type": "recipient_view_object_type",
      "send_as_user_id": "send_as_user_id",
      "subject": "subject",
      "template_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "timezone": "timezone",
      "webhook_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
    }
  ],
  "changeset": {
    "combinator": "AND",
    "filter": [
      {
        "foo": "bar"
      }
    ]
  },
  "created_at": "created_at",
  "enabled": true,
  "list_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "on_create": true,
  "on_delete": true,
  "state": {
    "combinator": "AND",
    "filter": [
      {
        "foo": "bar"
      }
    ]
  },
  "team_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "updated_at": "updated_at",
  "user_id": "user_id"
}