Skip to main content
GET
/
agents
cURL
curl 'https://api.gumloop.com/api/v1/agents?team_id=YOUR_TEAM_ID&search=research' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
{
  "agents": [
    {
      "id": "abc123DEFghiJKL",
      "name": "Sales research agent",
      "description": "Researches accounts and drafts outreach",
      "team_id": "team_4f8c92ab",
      "is_active": true,
      "model_name": "anthropic/claude-sonnet-4",
      "system_prompt": "You are a B2B sales research assistant.",
      "tools": [],
      "resources": [],
      "metadata": {},
      "folder_id": null,
      "created_at": "2026-05-15T14:32:00Z",
      "active_trigger_count": 2
    },
    {
      "id": "xYz789AbCdEfGhI",
      "name": "Support triage",
      "description": "Triages incoming support tickets",
      "team_id": "team_4f8c92ab",
      "is_active": true,
      "model_name": "openai/gpt-5",
      "system_prompt": null,
      "tools": [],
      "resources": [],
      "metadata": {},
      "folder_id": null,
      "created_at": "2026-04-02T09:11:00Z",
      "active_trigger_count": 0
    }
  ],
  "next_cursor": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Query Parameters

team_id
string

Scope the listing to a single team. When omitted, returns agents owned by the authenticated user.

Case-insensitive substring match against the agent name.

creator
string

Filter to agents created by this user ID.

has_triggers
boolean

When true, only returns agents that have at least one active trigger configured.

tool
string

Filter to agents that use the specified MCP server as a tool.

flow
string

Filter to agents that use the specified saved flow as a tool.

Response

Agents matching the provided filters.

agents
object[]
next_cursor
string

Reserved for future cursor-based pagination. Currently always null.

Example:

null