---
title: "Get Agents By Folder"
method: GET
path: "/v1/get-agents-by-folder/{folder_id}"
tags: ["Folders"]
---

# Get Agents By Folder

`GET /v1/get-agents-by-folder/{folder_id}`

Get all agents in a specific folder.

Returns a list of agent IDs and names in the folder.

## Path parameters

- `folder_id` string, uuid, required

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- AgentPydantic[]
  - `id` union
    - integer
    - string
  - `bluejay_as_code_id` string, uuid, nullable
  - `name` string, required
  - `agent_description` string, required
  - `organization_id` string, required
  - `workspace_id` string, nullable
  - `goals` string[], nullable
  - `mode` 'VOICE' | 'TEXT', required — Enum representing the mode of agent
  - `type` 'INBOUND' | 'OUTBOUND' — Enum representing the type of agent
  - `connection_type` 'SMS' | 'HTTP_WEBHOOK' | 'PHONE' | 'SIP' | 'WEBSOCKET' | 'LIVEKIT' | 'PIPECAT' | 'ELEVEN_LABS' | 'RETELL' | 'VAPI' | 'KORE' | 'SIERRA_VOICE' | 'AMELIA_CHAT' | 'AMELIA_VOICE' | 'GOOGLE_CES_CHAT' | 'GOOGLE_CES_VOICE' | 'GOOGLE_DFCX_VOICE' | 'GOOGLE_DFCX_CHAT' | 'BLAND_PHONE' | 'BLAND_VOICE' | 'BLAND_CHAT' — Enum representing the connection type of the agent
  - `phone_number` string, nullable
  - `follow_up_sms_sender_numbers` string[], nullable
  - `websocket_url` string, nullable
  - `redact_pii` boolean, nullable
  - `folder_id` string, uuid, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `updated_by` string, uuid, nullable
  - `created_by` string, uuid, nullable
  - `keyterms` string[], nullable
  - `voice_provider` string, nullable
  - `provider_id` string, nullable
  - `websocket_username` string, nullable
  - `websocket_password` string, nullable
  - `external_agent_id` string, nullable
  - `sip_uri` string, nullable
  - `custom_sip_headers` object, nullable
  - `sip_username` string, nullable
  - `sip_password` string, nullable
  - `simulation_notifications` object
  - `livekit_agent_name` string, nullable
  - `livekit_metadata` object, nullable
  - `livekit_customer_tool_topic` string, nullable
  - `livekit_token_webhook_url` string, nullable
  - `livekit_token_webhook_auth` string, nullable
  - `pipecat_agent_name` string, nullable
  - `pipecat_agent_configuration` object, nullable
  - `pipecat_room_properties` object, nullable
  - `http_webhook` string, nullable
  - `http_webhook_key` string, nullable
  - `dynamic_sip_webhook_url` string, nullable
  - `outbound_trigger_webhook_url` string, nullable
  - `outbound_trigger_payload_template` object, nullable
  - `eleven_labs_agent_id` string, nullable
  - `retell_agent_id` string, nullable
  - `vapi_assistant_id` string, nullable
  - `ces_app_id` string, nullable
  - `ces_deployment_id` string, nullable
  - `dfcx_project_id` string, nullable
  - `dfcx_location` string, nullable
  - `dfcx_agent_id` string, nullable
  - `amelia_base_url` string, nullable
  - `amelia_domain_code` string, nullable
  - `amelia_flow_name` string, nullable
  - `amelia_agent_name` string, nullable
  - `bland_pathway_id` string, nullable
  - `bland_agent_id` string, nullable
  - `bland_persona_id` string, nullable
  - `kore_host` string, nullable
  - `kore_bot_id` string, nullable
  - `kore_client_id` string, nullable
  - `kore_client_secret` string, nullable
  - `kore_inbound_token` string, nullable
  - `enable_outbound_call_auto_start` boolean, nullable
  - `simulations_disabled` boolean, nullable
  - `workflow` object, nullable
  - `provider` 'CUSTOM' | 'ELEVENLABS' | 'VAPI' | 'RETELL' | 'GOOGLE_CES_VOICE' | 'GOOGLE_CES_CHAT' | 'GOOGLE_DFCX_VOICE' | 'GOOGLE_DFCX_CHAT' | 'AMELIA' | 'BLAND' — Source platform the agent's definition (system prompt, workflow) comes from. Distinct from `voice_provider` (TTS/STT vendor) and `provider_id` (handle on that vendor) — this identifies where the agent's *behavior* (prompt, multi-agent graph) is authored.
  - `red_team_profile` object, nullable

## Other responses

- `422` — Validation Error

## Changes

> 19 revisions in range; 15 could not be searched.

- **2026-08-04** `90ededf7fc7d` — 3 warning, 3 info
  - added the new `BLAND` enum value to the `items/provider/anyOf[subschema #1: Provider]/` response property for the response status `200`
  - added the new `BLAND_CHAT` enum value to the `items/connection_type/anyOf[subschema #1: ConnectionType]/` response property for the response status `200`
  - added the new `BLAND_VOICE` enum value to the `items/connection_type/anyOf[subschema #1: ConnectionType]/` response property for the response status `200`
  - added the optional property `items/bland_agent_id` to the response with the `200` status
  - …2 more
- **2026-07-31** `4309a961859b` — 3 warning, 9 info
  - added the new `AMELIA` enum value to the `items/provider/anyOf[subschema #1: Provider]/` response property for the response status `200`
  - added the new `AMELIA_CHAT` enum value to the `items/connection_type/anyOf[subschema #1: ConnectionType]/` response property for the response status `200`
  - added the new `AMELIA_VOICE` enum value to the `items/connection_type/anyOf[subschema #1: ConnectionType]/` response property for the response status `200`
  - added the optional property `items/amelia_agent_name` to the response with the `200` status
  - …8 more
- …earlier changes not shown

[Full history](https://skmtc.dev/getbluejay/apis/bluejay-api/changes/v1/get-agents-by-folder/:folder_id/get.md)

---

[API](https://skmtc.dev/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.dev/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/revisions/bf69ab7268a4/schema)