Skip to main content
POST
Start an agent chat

Authorizations

Authorization
string
header
required

API key obtained from your Tella account settings

Body

application/json
prompt
string
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.

Required string length: 1 - 20000
Example:

"Import https://www.youtube.com/watch?v=dQw4w9WgXcQ, cut it to the best 60 seconds and add captions."

name
string

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

Maximum string length: 120
Example:

"Launch recap"

videoId
string

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

Example:

"vid_abc123def456"

Response

Created

chatId
string
required
Example:

"achat_abc123def456"

url
string
required

Opens the chat in the video's editor

Example:

"https://www.tella.tv/video/vid_abc123def456/edit?agentChat=achat_abc123def456"

videoId
string
required
Example:

"vid_abc123def456"