Skip to main content
GET
List Agents

Overview

Lists all agents within your active organization. The response is filtered based on your user role:
  • Owners/Admins: See all agents (public + private)
  • Members: See public agents + their own private agents only
Authentication: Session-based (Better Auth) Scope: Active organization from session

Request

Headers:
Query Parameters: None

Response

Status: 200 OK

Response Fields

Access Control

Owners/Admins

Members

Error Responses

401 Unauthorized

400 Bad Request

403 Forbidden

500 Server Error

Examples

cURL

JavaScript (Fetch)

Next.js (Server Component)

Authorizations

x-api-key
string
header
required

Your TalkifAI API key. Generate from Studio → Settings → API Keys. Format: tk_live_...

Response

List of agents

success
boolean
data
object