List agents

  • Updated on Oct 25, 2026
  • Published on Oct 25, 2026
Prev Next
Get
/v1alpha/agents

Returns all agents in your workspace.

Security
HTTP
Type bearer
Responses
200

A successful response.

Expand All
object
agents
Array of object (agents_hubv1alphaAgent)

The agents in your workspace.

object

Agent contains the key identifying details of an agent, as returned by List agents and Get agent.

id
string
name
string
description
string
status
string

AgentStatus represents the lifecycle status of an agent.

  • AGENT_STATUS_UNSPECIFIED: Unspecified or unknown status.
  • AGENT_STATUS_DRAFT: Draft: the agent has no published revision.
  • AGENT_STATUS_PUBLISHED: Published: the agent's latest revision is published, with no unpublished changes.
  • AGENT_STATUS_UNPUBLISHED_CHANGES: Unpublished changes: the agent has a published revision, but a newer draft exists.
Valid values[ "AGENT_STATUS_UNSPECIFIED", "AGENT_STATUS_DRAFT", "AGENT_STATUS_PUBLISHED", "AGENT_STATUS_UNPUBLISHED_CHANGES" ]
Default"AGENT_STATUS_UNSPECIFIED"
401

Invalid bearer token. If you receive this message more than once try creating a new Client ID/Client Secret or generating a new bearer token.

object
403

You don't have permission to access this resource.

object