Skip to content

Get Video Permissions

This API gives you a list of users and the permissions assigned to them on the video.

Endpoint

    GET api/v1/admin/projects/<project_key>/videos/<video_key>/roles

Headers

Header Value
Authorization Bearer api_key.

Response Body

    {
        "admins": ["adminuser@example.com"],
        "publishers": ["user1@example.com", "user2@example.com", "user3@example.com"],
        "uploaders": ["uploader1@example.com", "uploader2@example.com"],
        "video_permissions": true,
        "status_code": "A0000",
        "status_message": "Success",
    }
| Field | Type | Description | |---------------------|----------------|-----------------------------------------------------| | admins | String | Users can be granted admin permissions for a project, allowing them to edit the project, publish videos, upload videos, edit videos, delete videos, and manage permissions for other users on the project. |
| publishers | String | Users can be granted publisher permissions for a project, enabling them to publish videos from that project. |
| uploaders | String | Users can be granted uploader permissions for a project, allowing them to upload videos to that project. |
| analyst | String | Users can be granted analyst permissions for a project, allowing them to access and review analytics data for that project. |
| video_permissions | Boolean | This param indicates that some users are given permissions on that video and it would override the project permissions. |
| status_message | String | This field contains either an error message or a success message, depending on the API call. In some cases, it also includes the status of the object, such as the current state of a video. |
| status_code | String | This is the representation of the status in code form. |

Error Codes

Indee provides a comprehensive list of Error Codes. To know more, see Common Error and Success Codes.