WIwithchima
Videos

Add a collaborator to a video

Changed on

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

post/v1/videos/{id}/collaborators

Request

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

  • ac47c99c144fRevision changes
    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

    • warning

      added the new edit_conflict enum value to the response property for the response status

  • db4b5f8b1f3fRevision changes
    • warning

      changed the pattern of the request property from ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ to ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$

    • info

      the / response's property pattern was changed from ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ to ^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ for the status