Videos

Add a collaborator to a video

Grants access to a video for the specified user. The user must be a member of your workspace.

post/v1/videos/{id}/collaborators

Request

  • Base URL: https://api.tella.com
  • URL: https://api.tella.com/v1/videos/{id}/collaborators
  • Auth: HTTP bearer

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Request body

emailstring email required

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

role'editor' | 'viewer' required

Role to grant. Allowed values: 'editor' or 'viewer'.

Example request

{
  "email": "editor@example.com",
  "role": "editor"
}

Response

Collaborator added successfully

Example response

{
  "collaborator": {
    "email": "editor@example.com",
    "name": "Jane Doe",
    "role": "editor",
    "userId": "usr_abc123def456"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.