Skip to main content
POST
Add a collaborator to a video

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. Allowed values: 'editor' or 'viewer'.

Available options:
editor,
viewer
Example:

"editor"

Response

Collaborator added successfully

Response after adding a collaborator to a video

collaborator
object
required

A collaborator on a video