Skip to main content

list_action_agents

List Action Agent discovery metadata for an organization. The tool does not return Studio config.

list_action_agents

List agent discovery metadata (id, name, description, model, tags). It does not return system prompts, studio layout, tools, or outbound MCP connections. Creating agents stays in the ActionFlows app.

Use this when you need agent ids for chat. If you already have an id, call get_action_agent.

See Installation for auth, pagination, and response_format.

Arguments

ArgumentTypeRequiredDescription
organizationIdstringNoOrganization ID. Required unless the API key is organization-scoped.
limitnumberNoMaximum agents to return, 1-100. Default 50.
offsetnumberNoNumber of agents to skip. Default 0.
response_formatjson or markdownNoDefault json.

Example

{
  "organizationId": "org_123",
  "limit": 20
}

Returns

JSON with success, action_agents, count, total, offset, has_more, and next_offset when another page exists.

On this page