Permissions

Account Permissions

To get your permissions within an account, the accountrights call can be used, see Accounts.

Permission Description

Permission	Description
`ACCOUNT_OWNER`	The user is the owner of the account. There is exactly one owner per account. The user can do anything a user with `ACCOUNT_MANAGE` can do, but also view and edit the billing details and change the subscription details.
`ACCOUNT_MANAGE`	The user has admin rights in the account, so has access to the account settings, except for billing details.
`ACCOUNT_CREATE_PRODUCTION`	The user can create productions in the account but has no other administrative account rights.
`ACCOUNT_VIEW`	The user can view the account

ACCOUNT_OWNER

The user is the owner of the account. There is exactly one owner per account. The user can do anything a user with ACCOUNT_MANAGE can do, but also view and edit the billing details and change the subscription details.

ACCOUNT_MANAGE

The user has admin rights in the account, so has access to the account settings, except for billing details.

ACCOUNT_CREATE_PRODUCTION

The user can create productions in the account but has no other administrative account rights.

ACCOUNT_VIEW

The user can view the account

Production Permissions

To get your permissions within a particular workspace, you can use this call

GET /api/production/2513/rights

It will return an array of permission strings.

Permission Description

Permission	Description
PRODUCTION_MANAGE	Admin rights in the production. The user can see and edit the workspace settings.
TEAM_MANAGE	Edit workspace team members and roles. Send invites.
LIBRARY_UPLOAD	Upload material into the workspace. Upload attachments to clips.
LIBRARY_UPDATE_METADATA	Edit description, tags, and other metadata for clips. Necessary requirement for starting the automatic generation of a summary.
LIBRARY_SHARE	Share material with people who are not part of the workspace
LIBRARY_VIEW_CONFIDENTIAL	All users who can upload media can also attach documents to a clip. Some of these documents can be marked confidential. Users with this permission can see confidential clip attachments
LIBRARY_DOWNLOAD_PROXY LIBRARY_DOWNLOAD_EDL LIBRARY_DOWNLOAD_RAW	The user can download material from the production. There is a permission per type of MediaObjectInstance (PROXY, EDL, RAW).
LIBRARY_DELETE	The user can delete clips and annotations from the production.
LIBRARY_ASSIGN	The user can assign Annotations to an EditorialObject in the production
COLLECTION_BUILDER_EDIT SCREENPLAY_BUILDER_EDIT STORY_BUILDER_EDIT	The user can create and edit the contents of EditorialObjects in the production. There is a separate permission for 'regular' collection builder, screenplay builder and story builder.
LOG_EDIT	Create and edit ClipAnnotation (funnel ClipAnnotation) annotations in the logger application
REVIEW_EDIT	Create and edit ClipAnnotation (funnel ReviewComment) annotations in the review application
REVIEW_STATUS_EDIT	Change review status
REVIEW_EDIT_ALL	Create and edit ClipAnnotation (funnel ReviewComment) annotations in the review application, even if they are not created by you.
VIEW_COMMENT_INTERNAL	View comments that have restricted visibility.
UI_VIEW_ANNOTATION_CREATOR	View the name of the creator of the comment. This permission is only enforced in the UI, via the API, the creator will be returned even if the user does not have this permission.
TRANSCRIBER_EDIT	Create, update, delete TranscriptAnnotations.
SUBTITLE_EDIT	Create, update, delete Subtitle annotations.
START_TRANSCRIPTION_WORKFLOW	Start the automatic transcription workflow. This will reduce your transcription credits.
START_TRANSLATION_WORKFLOW	Start automated translation of transcription and subtitles. This will reduce your translation credits.
START_SUBTITLE_WORKFLOW	Start automated subtitling.
DELIVERY_REQUEST_MANAGE	Manage the parameters of a Delivery Request. Things like setting the due date, filling in the Delivery Request’s form fields, setting the assignee and reviewer.
DELIVERY_REQUEST_UPDATE	Necessary for creating, cloning, editing, reopening a `DeliveryRequestSubmission`. Filling in the `DeliveryRequestSubmission` form metadata, attaching and detaching files to a submission.
DELIVERY_REQUEST_SUBMIT	People with this permission can submit a `DeliveryRequestSubmission` for review. This permission is also necessary to set the expected delivery date of a `DeliveryRequest`. Mark rejected parts of a submission as resolved. People with this permission can become the assignee of a `DeliveryRequest`.
DELIVERY_REQUEST_ARCHIVE	Archive or Unarchive a `DeliveryRequest` or a `DeliveryRequestSubmission`.
DELIVERY_REQUEST_REVIEW	Reject or approve a `DeliveryRequestSubmission`. Mark parts of a submission as rejected (partial reject). Mark rejected parts of a submission as resolved. Lock or unlock a Delivery Request. People with this permission can become the reviewer of a `DeliveryRequest`.
USER_COMMENT_EDIT	The user can create or edit their own `UserComment` comments.
USER_COMMENT_EDIT_ALL	The user can create or edit `UserComment` comments, even if the comment was created by someone else.

PRODUCTION_MANAGE

Admin rights in the production.

The user can see and edit the workspace settings.

TEAM_MANAGE

Edit workspace team members and roles. Send invites.

LIBRARY_UPLOAD

Upload material into the workspace. Upload attachments to clips.

LIBRARY_UPDATE_METADATA

Edit description, tags, and other metadata for clips.

Necessary requirement for starting the automatic generation of a summary.

LIBRARY_SHARE

Share material with people who are not part of the workspace

LIBRARY_VIEW_CONFIDENTIAL

All users who can upload media can also attach documents to a clip. Some of these documents can be marked confidential. Users with this permission can see confidential clip attachments

LIBRARY_DOWNLOAD_PROXY LIBRARY_DOWNLOAD_EDL LIBRARY_DOWNLOAD_RAW

The user can download material from the production. There is a permission per type of MediaObjectInstance (PROXY, EDL, RAW).

LIBRARY_DELETE

The user can delete clips and annotations from the production.

LIBRARY_ASSIGN

The user can assign Annotations to an EditorialObject in the production

COLLECTION_BUILDER_EDIT SCREENPLAY_BUILDER_EDIT STORY_BUILDER_EDIT

The user can create and edit the contents of EditorialObjects in the production. There is a separate permission for 'regular' collection builder, screenplay builder and story builder.

LOG_EDIT

Create and edit ClipAnnotation (funnel ClipAnnotation) annotations in the logger application

REVIEW_EDIT

Create and edit ClipAnnotation (funnel ReviewComment) annotations in the review application

REVIEW_STATUS_EDIT

Change review status

REVIEW_EDIT_ALL

Create and edit ClipAnnotation (funnel ReviewComment) annotations in the review application, even if they are not created by you.

VIEW_COMMENT_INTERNAL

View comments that have restricted visibility.

UI_VIEW_ANNOTATION_CREATOR

View the name of the creator of the comment. This permission is only enforced in the UI, via the API, the creator will be returned even if the user does not have this permission.

TRANSCRIBER_EDIT

Create, update, delete TranscriptAnnotations.

SUBTITLE_EDIT

Create, update, delete Subtitle annotations.

START_TRANSCRIPTION_WORKFLOW

Start the automatic transcription workflow. This will reduce your transcription credits.

START_TRANSLATION_WORKFLOW

Start automated translation of transcription and subtitles. This will reduce your translation credits.

START_SUBTITLE_WORKFLOW

Start automated subtitling.

DELIVERY_REQUEST_MANAGE

Manage the parameters of a Delivery Request. Things like setting the due date, filling in the Delivery Request’s form fields, setting the assignee and reviewer.

DELIVERY_REQUEST_UPDATE

Necessary for creating, cloning, editing, reopening a DeliveryRequestSubmission. Filling in the DeliveryRequestSubmission form metadata, attaching and detaching files to a submission.

DELIVERY_REQUEST_SUBMIT

People with this permission can submit a DeliveryRequestSubmission for review.

This permission is also necessary to set the expected delivery date of a DeliveryRequest.

Mark rejected parts of a submission as resolved.

People with this permission can become the assignee of a DeliveryRequest.

DELIVERY_REQUEST_ARCHIVE

Archive or Unarchive a DeliveryRequest or a DeliveryRequestSubmission.

DELIVERY_REQUEST_REVIEW

Reject or approve a DeliveryRequestSubmission.

Mark parts of a submission as rejected (partial reject). Mark rejected parts of a submission as resolved.

Lock or unlock a Delivery Request.

People with this permission can become the reviewer of a DeliveryRequest.

USER_COMMENT_EDIT

The user can create or edit their own UserComment comments.

USER_COMMENT_EDIT_ALL

The user can create or edit UserComment comments, even if the comment was created by someone else.

Production Permissions in the Flow UI

In the Flow UI Role edit dialog, the above permissions are sometimes called differently. Also, some permissions are grouped together in the Flow UI.

Flow UI Permission Category Flow UI Permission Corresponds to Production Permission(s)

Flow UI Permission Category	Flow UI Permission	Corresponds to Production Permission(s)
Production	Edit Settings	`PRODUCTION_MANAGE`
	Edit Team	`TEAM_MANAGE`
Library	Upload Media	`LIBRARY_UPLOAD`
	Edit Clip Metadata	`LIBRARY_UPDATE_METADATA`
	Share Clips	`LIBRARY_SHARE`
	View Confidential Clip Attachments	`LIBRARY_VIEW_CONFIDENTIAL`
	Download Proxy Media	`LIBRARY_DOWNLOAD_PROXY`
	Download Original Media	`LIBRARY_DOWNLOAD_RAW`
	Download Transcoded Media	`LIBRARY_DOWNLOAD_EDL`
	Delete Clips	`LIBRARY_DELETE`
	Manage Collections	Will enable both `LIBRARY_ASSIGN` AND `COLLECTION_BUILDER_EDIT`
	Assign To Collections	`LIBRARY_ASSIGN`
	Logging / Commenting	`LOG_EDIT`
Review	Create comments	`REVIEW_EDIT`
	Edit all comments	`REVIEW_EDIT_ALL`
	Change review status	`REVIEW_STATUS_EDIT`
	View Restricted Comments	`VIEW_COMMENT_INTERNAL`
	View Comment Creator	`UI_VIEW_ANNOTATION_CREATOR`
Transcriber & Subtitle Editor	Edit Transcript	`TRANSCRIBER_EDIT`
	Edit Subtitles	`SUBTITLE_EDIT`
	Start Automatic Transcription	Will enable both `START_TRANSCRIPTION_WORKFLOW` and `START_SUBTITLE_WORKFLOW`.
	Start Automatic Translation	`START_TRANSLATION_WORKFLOW`
Story & Screenplay Builder	Edit Stories & Screenplays	Will enable both `SCREENPLAY_BUILDER_EDIT` and `STORY_BUILDER_EDIT`
Edge	Edge Flow Ingest	Will enable `LIBRARY_UPLOAD`, `LIBRARY_UPDATE_METADATA`, `LIBRARY_ASSIGN` and `COLLECTION_BUILDER_EDIT`
Delivery Workspace Requests	Manage Request	`DELIVERY_REQUEST_MANAGE`
	Update Request	`DELIVERY_REQUEST_UPDATE`
	Submit Request	`DELIVERY_REQUEST_SUBMIT`
	Archive Request	`DELIVERY_REQUEST_ARCHIVE`
	Review Request	`DELIVERY_REQUEST_REVIEW`
	Create Comment (under "Delivery Workspace Requests" section)	`USER_COMMENT_EDIT`

Production

Edit Settings

PRODUCTION_MANAGE

Edit Team

TEAM_MANAGE

Library

Upload Media

LIBRARY_UPLOAD

Edit Clip Metadata

LIBRARY_UPDATE_METADATA

Share Clips

LIBRARY_SHARE

View Confidential Clip Attachments

LIBRARY_VIEW_CONFIDENTIAL

Download Proxy Media

LIBRARY_DOWNLOAD_PROXY

Download Original Media

LIBRARY_DOWNLOAD_RAW

Download Transcoded Media

LIBRARY_DOWNLOAD_EDL

Delete Clips

LIBRARY_DELETE

Manage Collections

Will enable both LIBRARY_ASSIGN AND COLLECTION_BUILDER_EDIT

Assign To Collections

LIBRARY_ASSIGN

Logging / Commenting

LOG_EDIT

Review

Create comments

REVIEW_EDIT

Edit all comments

REVIEW_EDIT_ALL

Change review status

REVIEW_STATUS_EDIT

View Restricted Comments

VIEW_COMMENT_INTERNAL

View Comment Creator

UI_VIEW_ANNOTATION_CREATOR

Transcriber & Subtitle Editor

Edit Transcript

TRANSCRIBER_EDIT

Edit Subtitles

SUBTITLE_EDIT

Start Automatic Transcription

Will enable both START_TRANSCRIPTION_WORKFLOW and START_SUBTITLE_WORKFLOW.

Start Automatic Translation

START_TRANSLATION_WORKFLOW

Story & Screenplay Builder

Edit Stories & Screenplays

Will enable both SCREENPLAY_BUILDER_EDIT and STORY_BUILDER_EDIT

Edge

Edge Flow Ingest

Will enable LIBRARY_UPLOAD, LIBRARY_UPDATE_METADATA, LIBRARY_ASSIGN and COLLECTION_BUILDER_EDIT

Delivery Workspace Requests

Manage Request

DELIVERY_REQUEST_MANAGE

Update Request

DELIVERY_REQUEST_UPDATE

Submit Request

DELIVERY_REQUEST_SUBMIT

Archive Request

DELIVERY_REQUEST_ARCHIVE

Review Request

DELIVERY_REQUEST_REVIEW

Create Comment (under "Delivery Workspace Requests" section)

USER_COMMENT_EDIT

Share Permissions

Permission	Description
VIEW	Allow users to view everything declared within the share
DOWNLOAD_PROXY	Users with the share link can view/download the PROXY version of the material
DOWNLOAD	Users with the share link can download all versions of the material
UPLOAD	Users with the share link can upload new material to the share. This material will appear in the production the share belongs to.
REVIEW	Users with the share link can create ClipAnnotation (funnel ReviewComment) annotations in it
REVIEW_STATUS_EDIT	Users with the share link can change the Review status of the material
MANAGE	Allow users to fully control all items within the share

Permission

Description

VIEW

Allow users to view everything declared within the share

DOWNLOAD_PROXY

Users with the share link can view/download the PROXY version of the material

DOWNLOAD

Users with the share link can download all versions of the material

UPLOAD

Users with the share link can upload new material to the share. This material will appear in the production the share belongs to.

REVIEW

Users with the share link can create ClipAnnotation (funnel ReviewComment) annotations in it

REVIEW_STATUS_EDIT

Users with the share link can change the Review status of the material

MANAGE

Allow users to fully control all items within the share