Skip to main content
POST
/
v1
/
videos
/
{id}
/
collaborators
Add a collaborator to a video
curl --request POST \
  --url https://api.tella.com/v1/videos/{id}/collaborators \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "editor@example.com",
  "role": "editor"
}
'
{
  "collaborator": {
    "email": "editor@example.com",
    "name": "Jane Doe",
    "role": "editor",
    "userId": "usr_abc123def456"
  }
}

Authorizations

​
Authorization
string
header
required

API key obtained from your Tella account settings

Path Parameters

​
id
string
required

Unique video identifier

Example:

"vid_abc123def456"

Body

application/json

Request body for adding a collaborator to a video

​
email
string<email>
required

Email address of the user to add. Must be a member of your workspace.

Pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$
Example:

"editor@example.com"

​
role
enum<string>
required

Role to grant. Currently only 'editor' is supported.

Available options:
editor
Example:

"editor"

Response

Collaborator added successfully

Response after adding a collaborator to a video

​
collaborator
object
required

A collaborator on a video