Skip to main content
GET
Get automation

Permissions

Requires a service user with the ViewOrgAutomations permission at the organization level.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

automation_id
string
required
org_id
string
required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

Response

Successful Response

actions
(AutomationStartSessionAction · object | AutomationMessageSessionAction · object | AutomationMonitorSessionAction · object)[]
required
automation_id
string
required
created_at
integer
required
created_by
ActorResponse · object
required

A user or service-user principal attributed to an action or resource.

enabled
boolean
required
name
string
required
triggers
AutomationTriggerResponse · object[]
required
updated_at
integer
required
concurrency
AutomationConcurrency · object | null
last_edited_by
ActorResponse · object | null

A user or service-user principal attributed to an action or resource.

last_invocation
AutomationLastInvocation · object | null
limits
AutomationLimits · object | null
metadata
Metadata · object
notifications
AutomationNotifications · object | null
run_as
AutomationRunAsOrganization · object

Identity the spawned sessions run under. organization: the org's automation identity (the System User in the app) — sessions use system permissions, so MCP servers installed with a personal (user-scoped) connection cannot be selected, and switching an automation to organization removes them from its selection. creator: personal automation — runs with the creator's own permissions and is visible only to the creator and org admins; rejected for service-user-created automations. Required on create; null on update resets to organization.

security_profile
AutomationSecurityProfileResponse · object | null

The automation's security-profile binding and the resolved governing profiles. null when security profiles are not enabled for the organization.

session_settings
AutomationSessionSettings · object | null

Applied to every session this automation spawns (including monitor sessions).

template_id
string | null
tools
AutomationTools · object | null