---
title: "List Experts"
method: GET
path: "/api/experts"
tags: ["v2", "experts", "experts", "private"]
---

# List Experts

`GET /api/experts`

List the user's active hired experts.

## Response `200`

Successful Response

- Expert[]
  - `id` string, required
  - `name` string, required
  - `avatar_url` string, nullable, required
  - `color` string
  - `role` string, required
  - `tagline` string, nullable, required
  - `bio` string, nullable, required
  - `skills` string[], required
  - `identity` string, required
  - `voice_preferences` string, required
  - `voice_samples` VoiceSample[]
    - `label` string, required
    - `text` string, required
  - `boundaries` string, required
  - `protected_soul_rules` string[], required
  - `is_template` boolean, required
  - `source_template_id` string, nullable, required
  - `is_archived` boolean, required
  - `workflows` ExpertWorkflowRef[], required
    - `id` string, required
    - `store_listing_version_id` string, nullable, required
    - `library_agent_id` string, nullable, required
    - `graph_id` string, nullable, required
    - `name` string, nullable, required
    - `description` string, nullable, required
    - `schedule_cron` string, nullable
    - `schedule_id` string, nullable
  - `last_run_at` string, date-time, nullable
  - `last_run_status` string, nullable
  - `weekly_budget` integer, nullable
  - `weekly_spend` integer
  - `schedules_paused_at` string, date-time, nullable
  - `pod_id` string, nullable

## Other responses

- `401` — Authentication required

## Changes

- **2026-08-18** `7a73da1c44a4` — 1 info
  - added the optional property `items/color` to the response with the `200` status
- **2026-08-18** `33733e416a7d` — 1 info
  - added the optional property `items/pod_id` to the response with the `200` status
- **2026-08-15** `ba45abd7747c` — 1 info
  - added the optional property `items/voice_samples` to the response with the `200` status
- **2026-08-09** `ce17332deb2d` — 3 info
  - added the required property `items/boundaries` to the response with the `200` status
  - added the required property `items/protected_soul_rules` to the response with the `200` status
  - added the required property `items/voice_preferences` to the response with the `200` status
- **2026-08-06** `3dfd3128358f` — 7 info
  - added the optional property `items/last_run_at` to the response with the `200` status
  - added the optional property `items/last_run_status` to the response with the `200` status
  - added the optional property `items/schedules_paused_at` to the response with the `200` status
  - added the optional property `items/weekly_budget` to the response with the `200` status
  - …3 more

[Full history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/experts/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/revisions/5dc375899754/schema)