---
title: "List a video's agent chats"
method: GET
path: "/v1/agent-chats"
tags: ["Agent chats"]
---

# List a video's agent chats

`GET /v1/agent-chats`

## Request

- Base URL: `https://api.tella.com`
- URL: `https://api.tella.com/v1/agent-chats`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/withchima/apis/tella-public-api/docs/v1/agent-chats/get.ts> (a function with typed inputs; its response is checked against the schema)

The editor agent chats in a video, most recently active first, each with its `status` and `lastReply`. Poll it to follow a chat you started: `idle` means its turn ended.

## Query parameters

- `videoId` string, required: The video whose agent chats to list

## Response `200`

OK

- ListAgentChatsResponse: The video's agent chats, most recently active first
  - `chats` AgentChat[], required
    - `chatId` string, required
    - `lastActiveAt` string, required
    - `lastReply` string: The agent's last reply, up to 6,000 characters
    - `startedBy` string: Who started the chat
    - `status` string, required: `running` while a turn is working, `waiting_for_answer` when the agent asked the user something (answered at `url`), `idle` once its turn ended, or `unknown`
    - `title` string
    - `url` string, required: Opens the chat in the video's editor

## Other responses

- `400`: The request was malformed or contained invalid parameters.
- `401`: Authentication is required. Provide a valid API key.
- `403`: You don't have permission to access this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with the resource's current state, e.g. an Idempotency-Key whose first request is still in progress. Retry once it settles.
- `429`: You have exceeded the rate limit. Please slow down.
- `500`: An unexpected error occurred
- `501`: The requested operation is not implemented.
- `503`: A dependency was unavailable and the request was not executed. Safe to resend unchanged after the Retry-After delay.

## Changes

> 65 revisions in range; 1 not diffed.

- **2026-10-27** `240a74ea0ff7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withchima/apis/tella-public-api/changes/v1/agent-chats/get.md)

---

[API](https://skmtc.dev/withchima/apis/tella-public-api.md) - [All operations](https://skmtc.dev/withchima/apis/tella-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withchima/apis/tella-public-api/revisions/0cc3fcd307ad?raw)