WIwithchima
Agent chats

Start an agent chat

Changed on

Start a chat with Tella's editor agent in a video you can edit, as if you had typed prompt in its agent chat; without videoId it first makes a new, empty video. The agent works in the background and spends the workspace's AI Credits. Follow it with GET /v1/agent-chats?videoId=.

post/v1/agent-chats

Request

Request body

namestring

The new video's name. Only used without videoId; left out, the prompt's start names it.

promptstring required

What the agent should do, in full: it is all the agent knows. Sent as if the user had typed it in the video's agent chat.

videoIdstring

A video you can edit. Leave it out to start the chat in a new, empty video.

Example request

{
  "name": "Launch recap",
  "prompt": "Import https://www.youtube.com/watch?v=dQw4w9WgXcQ, cut it to the best 60 seconds and add captions.",
  "videoId": "vid_abc123def456"
}

Response

Created

chatIdstring required
urlstring required

Opens the chat in the video's editor

videoIdstring required

Example response

{
  "chatId": "achat_abc123def456",
  "url": "https://www.tella.tv/video/vid_abc123def456/edit?agentChat=achat_abc123def456",
  "videoId": "vid_abc123def456"
}

Changes