Skip to content

Automation and Agents

Exchange automation secrets, manage workspace automations, and control visible agents over REST.

Best for Automation developer and Workspace manager Updated April 3, 2026
Overview

Overview

Workspace automations and visible agents are related, but they are not the same thing.

This topic separates installation work from agent work so the reader can change the right object at the right time.

What this topic helps you do

  • Create and maintain workspace automations safely.
  • Exchange automation secrets correctly.
  • Create and update visible agents under an automation.
Topic

This Topic in Other Interfaces

Open the same topic in another surface when the job belongs in the browser, REST API, or CLI instead.

Choose the Exact Guide

Each guide stays focused on one job so you can open the exact task instead of reading through one oversized overview.

API Automation and Agents

Exchange an Automation Secret

Exchange an automation secret for an access token.

4 steps ยท 1 examples
API Automation and Agents

List Automations

Review the current workspace automations before you create, update, or rotate one.

4 steps
API Automation and Agents

Create an Automation

Create the workspace automation boundary, issue the automation secret, and store that secret safely because it is only shown once.

4 steps
API Automation and Agents

Update an Automation

Change automation metadata, team boundaries, scopes, or suspension state without recreating the automation.

4 steps
API Automation and Agents

Rotate an Automation Secret

Issue a new automation secret when the old one should no longer be trusted, then replace it everywhere the old secret was used.

4 steps
API Automation and Agents

List Visible Agents

Review the current visible agent bindings before creating a new agent or editing an existing one.

4 steps
API Automation and Agents

Create a Visible Agent

Create a named visible agent under an existing installation so activity, assignees, and attribution can point to a meaningful product actor.

4 steps
API Automation and Agents

Update a Visible Agent

Change a visible agent name, team scope, role, or suspension state without recreating the binding.

4 steps