---
title: "Get all agents"
method: GET
path: "/public/v1/agents"
tags: ["public"]
---

# Get all agents

`GET /public/v1/agents`

## Request

- Base URL: `https://api.gurusup.com`
- URL: `https://api.gurusup.com/public/v1/agents`
- Auth: API key in header `x-api-key`

Retrieve a list of agents for the authenticated organization.

## Response `200`

A list of agents associated with the organization.

- AgentListItem[]
  - `id` string, required: Agent ID
  - `name` string, required: Agent name
  - `description` string, nullable: Agent description
  - `behavior` string, nullable: Agent behavior (auto_reply, generate_draft)
  - `created_at` string, date-time, required: Agent creation date

---

[API](https://skmtc.dev/gurusup/apis/gurusup-api.md) · [All operations](https://skmtc.dev/gurusup/apis/gurusup-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gurusup/apis/gurusup-api/revisions/8b3c86d4bf1e?raw)