> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telloai.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 대상 목록

> 통화에 쓸 에이전트·크루의 id, 이름, 설명을 조회해요.

## 할 수 있는 일

인증한 계정에서 발신 대상으로 고를 수 있는 에이전트와 크루를 조회해요.
[통화 생성](https://docs.telloai.io/developer/rest/create-call.md)의 `agentId` 또는 `crewId`에 이 목록의 id를 넣어요.
키에 실행 대상을 묶지 않고 **매 요청에서 대상을 지정**해요.

## 에이전트 목록

```http theme={null}
GET https://api.telloai.io/v1/agents
```

```bash theme={null}
curl "https://api.telloai.io/v1/agents" \
  --header "Authorization: Bearer <API_KEY>"
```

삭제되지 않았고 **배포 상태인 에이전트**를 돌려줘요. id 오름차순이에요. 쿼리나 요청 본문은
필요 없어요.

```json 200 예시 theme={null}
{
  "data": [
    {
      "id": "12",
      "name": "예약 안내",
      "description": "예약 일정을 확인하고 변경을 도와줘요"
    }
  ]
}
```

에이전트 목록은 배포 상태를 기준으로 해요. 실제 통화 생성 시점에는 운영에 반영된 판이
여전히 유효한지도 확인하므로, 목록을 읽은 뒤 설정이 바뀌면 생성이 거절될 수 있어요.

## 크루 목록

```http theme={null}
GET https://api.telloai.io/v1/crews
```

```bash theme={null}
curl "https://api.telloai.io/v1/crews" \
  --header "Authorization: Bearer <API_KEY>"
```

삭제되지 않았고 **운영에 반영된 판이 활성 상태인 크루**를 돌려줘요. id 오름차순이에요.
크루 원본을 편집 중이어도 기존 운영 판이 활성 상태면 목록에 남아요. 쿼리나 요청 본문은
필요 없어요.

```json 200 예시 theme={null}
{
  "data": [
    {
      "id": "34",
      "name": "예약 접수 흐름",
      "description": null
    }
  ]
}
```

## 응답 필드

두 엔드포인트 모두 성공하면 \*\*`200 OK`와 `{ data }`\*\*가 와요. `data`는 아래 필드를 가진
객체 배열이에요. 대상이 없으면 빈 배열이에요. 통화 목록과 달리 `nextCursor`는 없어요.

| 필드 | 타입 | 설명 |
| - | - | - |
| `id` | 문자열 | 에이전트 또는 크루 id예요. 숫자로 이루어진 문자열로 와요 |
| `name` | 문자열 | 대상 이름이에요 |
| `description` | 문자열 또는 `null` | 에이전트의 역할 설명 또는 크루 설명이에요. 없으면 `null`이에요 |

> [!WARNING]
>
> 에이전트 id와 크루 id는 **값이 겹칠 수 있어요.** `/agents`에서 받은 id는 `agentId`에,
> `/crews`에서 받은 id는 `crewId`에 넣으세요. 통화 생성에는 둘 중 정확히 하나만 넣어요.

이 목록에는 기본 대상 표시나 필수 시작 변수 목록을 싣지 않아요. 크루가 요구하는 시작 값은
[통화 생성의 필수 변수](https://docs.telloai.io/developer/rest/create-call.md#크루가-요구하는-값) 규칙을 확인하세요.
인증·처리 오류는 [REST 오류](https://docs.telloai.io/developer/rest/errors.md)에 있어요.

## 관련 문서

* [통화 생성](https://docs.telloai.io/developer/rest/create-call.md)
* [에이전트 관리](https://docs.telloai.io/agents/manage.md)
* [에이전트 크루](https://docs.telloai.io/agents/crew.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.