Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

Retrieve a single automation

GET/automations/{automation_id}Retrieve a single automation

Parameters

automation_idstring · uuidpathrequired

The ID of the automation.

Responses

200OKapplication/json
objectAutomation
connectionsarray of object

The connections between steps in the active version of the automation.

Show child attributes
Show array items

A connection between two steps in the automation graph.

fromstringrequired

The `key` of the source step.

tostringrequired

The `key` of the target step.

typestring

The type of connection. Defaults to `default`.

one of "default", "condition_met", "condition_not_met", "timeout", "event_received" · default "default"

created_atstring

The date and time the automation was created.

idstring

The ID of the automation.

namestring

The name of the automation.

objectstring

Type of the response object.

statusstring

The current status of the automation.

one of "enabled", "disabled"

stepsarray of object

The steps in the active version of the automation.

Show child attributes
Show array items

A step as returned when retrieving an automation.

configobject

Configuration for the step. Shape depends on `type`. For `delay` steps, config contains `{ duration: string }` with a human-readable duration (e.g. `"30 minutes"`). For `wait_for_event` steps, config contains `{ event_name: string, timeout?: string, filter_rule?: object }` where `timeout` is a human-readable duration.

keystring

The unique key of this step within the automation graph.

typestring

The type of automation step.

one of "trigger", "send_email", "delay", "wait_for_event", "condition", "contact_update", "contact_delete", "add_to_segment"

updated_atstring

The date and time the automation was last updated.

Example response
{
  "connections": [
    {
      "from": "string",
      "to": "string",
      "type": "default"
    }
  ],
  "created_at": "string",
  "id": "string",
  "name": "string",
  "object": "automation",
  "status": "disabled",
  "steps": [
    {
      "config": {},
      "key": "string",
      "type": "add_to_segment"
    }
  ],
  "updated_at": "string"
}
Documentation menu