---
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
  - `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' | '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
  - `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

---

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