Skip to content

List Visible Agents

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

Best for Workspace manager Updated April 3, 2026
API In this interface
4 steps Steps
3 interfaces Available in
Use this path when

Use the workspace agent list endpoint to read the current binding set.

What you'll finish here
  • Read the current agent inventory.
  • Choose the correct agent id.
  • Understand which installation each visible agent belongs to.

Where this happens

LabelValueNotes
EndpointGET /api/v1/workspaces/{workspaceId}/agentsLists visible agent bindings.

Same Task, Other Interfaces

Use the version that matches where you are working now. The subject matter stays the same; the delivery changes by surface.

Do the work

  1. 1. Resolve the workspace id first.
  2. 2. Call the agent list endpoint with a human token that has `workspace.automation.manage`.
  3. 3. Read the agent ids and installation relationships in the response.
  4. 4. Use the right agent id for later updates.

Keep Going in Automation and Agents

Stay in the same interface and move to the next closest task in this topic when needed.

Nearby Guides

These guides stay close to the current workflow so you can keep moving without restarting discovery.