Skip to main content
POST
List agents

Authorizations

Authorization
string
header
required

murmur API key: mur_<key_id>.

Body

application/json
parentId
object

Identifies an agent. The identity is (tenant, workspace, owner, agent path); the workspace scopes the agent's repos, environment, and base branches.

account
string

account scope — the ONLY control over which accounts are listed: "" = caller's own agents (default), "*" = every account, "joe" = one account under the caller's own provider, "service_profile/deploy" = one account under an explicit owner provider (the only way to scope across providers — a bare name always resolves under the caller's).

includeTerminal
boolean

Also include terminal (completed/failed/canceled) agents. This widens the phase filter only; it does NOT change the account scope (see account).

tenant
object

Tenant identifies an organization within a provider. It is the unit of multi-tenant scoping — all resources (agents, pools, VMs) belong to exactly one tenant.

Response

A successful response.

entries
object[]