Accounts

Used for performing operations on Accounts

get

Returns a list of Accounts

post

Creates a new account.

Performs operations on a single Account.

get

Returns the Account

delete

Deletes the Account

put

Updates the Account that the Id belongs to.

get

Returns a list of actions that can be performed.

post

Performs an action. Possible action types are - enable, disable, delete, approve, unapprove, destroy, destroy.

put

Updates an account.

A collection of comment.

get

Returns a list of Comments.

post

Adds a new Comment.

Performs operations on a single Comment.

get

Returns a Comment.

post

Copies an existing Account

A collection of follower.

get

Returns a list of users that are following this object.

A collection of attachment.

get

Returns a list of attachments.

post

Creates a new attachment.

get

Returns the details for a specific attachment on a specific user defined object.

put

Updates the comment for an existing attachment.

delete

Deletes an existing attachment.

A collection of history.

get

Returns a list of events.

get

Returns the metadata associated with the Account, including a href link to the metadata definition.

put

Updates the metadata instance associated with the metadata. A valid XML metadata structure is expected in the body. The updated metadata will be returned if the request was successful.

A collection of member object links.

get

Returns the Users associated with the Account.

A collection of workspace object links.

get

Returns the Workspaces defined for the Account.

A collection of subAccount object links.

get

Returns the Sub-Accounts defined for the Account.

A collection of property object links.

get

Returns a list of Properties defined for a specific Account. This is only available in 5.1.1 onwards.

post

Creates a new Account/System Property

put

Updates the properties for the Account.

delete

Deletes the properties for the Account.

A collection of role object links.

get

Returns the Roles defined for the Account.

get

Returns the Account Workspace defined for the Account.

get

Returns a list of Variants a specific Account.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

Account Properties

Used for performing operations on Account/System Properties

get

Returns a list of Account/System Properties

post

Returns a list of Account/System Properties

Performs operations on a single Account/System Property

get

Returns the Account/System Property

put

Updates the Account/System Property

delete

Deletes the Account/System Property

post

Copies an existing Workflow Definition.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

Account Workspace

get

Returns the corresponding Workspace for the account that is currently in use.

post

Copies an existing Workflow Definition.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

Actions

Perform operations on Actions

get

Returns a list of Actions Listing is based on supplied filters.

post

Create a new action for a given action type and plugin.

Perform operations on a specific Action

get

Returns details of the Action

put

Update the details of the Action

delete

Delete the Action

get

Returns a list of actions that can be performed.

post

Performs an action. Possible action types are - enable, disable, start, stop, delete, retry, cancel, schedule, approve, unapprove, destroy, destroy.

A collection of comment.

get

Returns a list of Comments.

post

Adds a new Comment.

Performs operations on a single Comment.

get

Returns a Comment.

post

Copies an existing Action.

A collection of follower.

get

Returns a list of users that are following this object.

A collection of attachment.

get

Returns a list of attachments.

post

Creates a new attachment.

get

Returns the details for a specific attachment.

put

Updates the comment for an existing attachment.

delete

Deletes an existing attachment.

A collection of history.

get

Returns a list of events.

get

Returns the metadata instance of the action including a href to the metadata definition.

put

Updates the metadata instance associated with the configuration. A valid XML metadata structure is expected in the body. The updated metadata will be returned if the request was successful.

get

Returns file instances associated with an action (could have no files, one or several instances)

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

get

Returns a list of variables associated with a specific action.

get

Returns the details for a specific variable that is associated with a particular action.

get

Returns a list of options that are available for the specific object variable.

Action Types

This resource lists all the action types that are associated with a specific asset.

get

Returns a list of all the action types that are associated with a specific asset.

Assets

This resource is used for managing Assets

get

Returns a list of Assets Listing is based on supplied filters

post

Create new placeholder asset.

Perform operations on a specific Asset

get

Returns the Asset object details (account, workspace, owner, title etc.), asset file information and technical information (media or image contexts). While it is not possible to retrieve the full storage location of the Asset via API calls, you can use this endpoint to retrieve the Asset file's originalFileName and its currentLocation (for example, the asset location file path on Azure in the response - /ooflexdev.blob.core.windows.net/.../e9f3859c-1821-44a7-a3b5-2c4086f6410c.jpg). You can also list multiple assets by entering a list of Asset ids separated by a semicolon e.g /api/assets;id=1234;id=2345;id=3456

put

Updates asset details (only editable properties). This endpoint also comes with an option set of schema which enables users to update the details of an existing asset.

get

Returns a list of existing annotations made against a timeline in MAM.

post

Creates an annotation on a timeline in MAM. When specifying an originatorContext you can enter MioAssetReview, QCReport, or leave the field empty.

get

Returns a list of existing annotations made against a timeline.

post

Enables a user to post a single annotation on a timeline. When specifying an originatorContext you can enter MioAssetReview, QCReport, or leave the field empty.

Performs operations on a specific Annotation.

put

Updates an existing comment (annotation).

delete

Deletes an existing annotation.

post

Enables a user to post one or more annotations on a timeline in MAM. When you post multiple annotations simultaneously, all annotations must be placed within a single array. Please also take note, that when you specify an originatorContext you can enter MioAssetReview, QCReport, or leave the field empty.

A collection of comment.

get

Returns a list of Comments.

post

Adds a new Comment.

Performs operations on a single Comment.

get

Returns a Comment.

post

Copies an existing Asset.

A collection of follower.

get

Returns a list of users that are following this object.

A collection of attachment.

get

Returns a list of attachments.

post

Creates a new attachment.

get

Returns the details for a specific attachment.

put

Updates the comment for an existing attachment.

delete

Deletes an existing attachment.

A collection of history.

get

Returns a list of events.

A collection of reference object links.

get

Returns a list of references.

get

Returns a list of reviews.

get

Returns the details for a specific review session.

delete

Deletes a specific review session.

get

Returns the list of actions available to a user in a specific review session. FlexREVIEW now enables exclusive reviews - when such a session is taken by a user, it cannot be assigned to another user unless it is released. If the review session specified in the request is exclusive AND a user has taken the review session, the response will include an exclusiveReviewer section. This section will NOT be included in the API response if the review session is released (ended or not taken). The possible actions returned in the response, depending on the type of the review session and the current user's permissions, are DOWNLOADED, WATCHED, APPROVE, TAKE, and RELEASE.

post

Enables a user to take action on a review session they are assigned to. The possible actions are DOWNLOADED, WATCHED, and APPROVE. In addition, FlexREVIEW now enables exclusive reviews (when an exclusive review session is taken by a user, it cannot be assigned to another user unless it is released). A review session can only be defined as exclusive or not during its creation. If the review session is exclusive and the current user has sufficient user permissions, two more possible actions are also TAKE (if the specified review session is exclusive and is not taken, this action enables the current user to take the review session exclusively) and RELEASE (if the specified review session is taken by the current user, this action unassigns the current user from the exclusive review session and releases that session as available for taking by another user or by the same one again). Please note that all action values must be capitalized in the POST request. For example, a request for endpoint /api/assets/10105/reviews/102313/actions with { "action":"TAKE" } in the request body will assign the exclusive review session with id 102313 to the current user. The TAKE and RELEASE actions are only available if the specified review session was created as exclusive AND your user permissions are sufficient (Permissions > Access > Roles > Permissions from the UI). You can force the release of a review session both via the UI and also via the API - if you have the correct permissions for that, there is no need for the review session to have been taken in order to be released. IMPORTANT - if a user is disabled in the system, all exclusive review sessions taken by that user will be released. If the specified review session is exclusive and is taken by the current user, when the current user finishes the review the review will get released. If an exclusive review session is approved, this will automatically release the session if it has been blocked.

get

Retrieves a list of comments made during a specific review session.

get

Retrieves a list of reviewers and the status for each reviewer in a specific review session.

get

Retrieves the status information for a specific reviewer in review session.

put

Enables a user to change the status information for a specific reviewer in review session.

post
put

Enables a user to post a comment against a specific range of frames within an asset, in a review session.

get

Returns the metadata associated with the asset, including a href link to the metadata definition. If you search using a specific metadata field and value, you must specify the metadata definition first. For example - /api/assets;metadataDefinitionId=123441;metadata=processing-profile-uri-id:II316007618_profile_no_drm_id;limit=1

put

Updates the metadata instance associated with the metadata. A valid XML metadata structure is expected in the body. The updated metadata will be returned if the request was successful.

A collection of job object links.

get

Returns a list of jobs associated with the asset. Listing composed of href links to the job resource and is based on supplied filters.

A collection of workflow object links.

get

Get a list of workflows, based on supplied filters.

Operations on asset keyframes.

get

Returns a list of keyframes, based on supplied filters.

post

Creates a new keyframe from an existing Asset.

get

Returns details of the specific keyframe.

put

Updates details of the keyframe.

delete

Deletes the keyframe.

get

Returns the keyframe image.

get

Returns a stream of bytes.

Used for viewing published players.

get

Returns a list of associated players.

Returns a list of Actions which can be executed on the asset based on its current state.

get

Returns a list of Actions that can be executed on the asset based on its current state.

post

Performs an action. Possible action types are - enable, disable, start, stop, delete, retry, cancel, schedule, approve, unapprove, destroy, destroy.

Performs operations on parent asset group memberships.

get

Returns a list of parent group memberships.

post

Creates a new membership with a parent group.

get

Returns details of the specific asset membership.

put

Updates the membership with the parent group.

delete

Delete the membership with the parent group.

Performs operations on child asset memberships for a given asset group.

get

Returns a list of asset memberships (children). This resource is only available for asset groups.

post

This endpoint enables you to add an existing asset to an asset group in MAM by specifying the asset ID. This endpoint also enables you to specify the index for the asset you are adding. You can use the index field to specify the order in which a new member will appear in a group. You can specify the order of an asset by entering a number in the index field. For example - you might have 10 members already in the group, but you may want your new member to be listed in 1st place. So in order for your new member to appear in 1st place, you would enter 1 in the index field.

delete

Deletes an existing membership.

put

This endpoint updates the order of an existing member within an asset group in MAM. For example - you might have 10 members in a group and you might want to change the order of one of the existing members. You can use the index field to change the order of a specific member by entering a number. If you wanted a member of the group to be listed in 5th place, you would enter 5 in the index field.

A collection of child object links.

get

Returns the child file Assets This is only available for file assets which have child file assets.

get

Returns the parent file Asset. This is only available for file assets which have a parent.

get

Returns a list of active proxies available for a specific Asset.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

get

Returns the media region that is associated to the asset if there is one. This is only available for 5.3.0 onwards.

post

Creates a new media region for a Clip or MediaAsset. This is only available for 5.3.0 onwards.

put

Updates the media region of an asset. This is only available for 5.3.0 onwards

delete

Deletes the media region of an asset if there is one. This is only available for 5.3.0 onwards.

get

Returns all placed media regions that belong to the specified asset. This is only available for 5.3.0 onwards.

post

Creates a new media region for a Sequence or MediaAsset. This is only available for 5.3.0 onwards. Media regions are only for clips or media-assets, but immutable for media-assets. Placed Media Regions are only for sequences or media-assets, but immutable for media-assets. Note that Timestamps are in microseconds.

get

Returns the placed media region found by specified id for a specified asset id. This is only available for 5.3.0 onwards.

put

Updates the placed media region found by specified id for a specified asset id. This is only available for 5.3.0 onwards.

get

Returns all of the subtitle assets that are linked to a specific media asset.

get

Returns a list of object hierarchies for the specified media asset. You can use two optional matrix parameters in the request for this endpoint - context and level. For example context=upward is used to request the upward hierarchy for the asset, and level specifies the number of levels (parents) in the object hierarchy (up to 6). The response should have the following fields - id, name, displayName, objectType, and a list of parent group assets. Example - /api/assets/31315/hierarchy;context=upward;level=2

Collections

This resource is used for viewing Collections.

get

Returns a list of Collections.

post

Creates a new Collection. Please note that you can now use the new fql property to save an FQL as a dynamic query. This is a new 'type' of collection that you can define by using an FQL query defined instead of a specific asset. The fql property is an optional string type that can contain up to 2000 characters. You can then use the GET method with type=dynamic matrix parameter to retrieve dynamic collections - for example, /api/collections;type=dynamic (see the GET method description for more information).

get

Returns Collection found by specified id.

put

Updates the collection.

delete

Deletes a Collection found by specified id.

put

Returns the Assets found by specified ID. You can also remove Assets from a collection.

get

Returns a list of items.

A collection of comment.

get

Returns comments for a specific collection.

post

Posts a new comment on a specific collection.

Performs operations on a single Comment.

get

Returns a specific comment for a specific collection.

put

Updates a comment for a specified Object within a collection.

delete

Deletes a comment on a specific object within a collection.

post

Copies an existing Collection.

A collection of follower.

get

Returns comments for a specific collection.

A collection of attachment.

get

Returns attachments for a specific collection.

post

Adds a new attachment to the collection.

get

Returns the details for a specific attachment.

put

Updates the comment for an existing attachment.

delete

Deletes an existing attachment.

A collection of history.

get

Returns the history for the given collection.

A collection of reference object links.

get

Returns the references for the given collection.

get

Returns the comments for the given Variable Instance.

post

Adds a new comment to the Variable Instance.

delete

Deletes a comment on a specific object within a collection.

get

Returns Sub-collections for the given collection.

A collection of keyframe.

get

Get all keyframe, optionally filtered

post

Sets a new Keyframe to the collection.

put

Updates the Collection's Keyframe with an existing one.

delete

Deletes a Keyframe for a collection.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

Evaluation

This resource is used for evaluating URLs for panel supported user defined objects.

post

This endpoint is used to evaluate URLs for panel supported user defined objects.

Events

This resource is used for viewing Events

get

Returns a list of Events. Listing is based on supplied filters.

post

Create a new Event

Perform operations on a specific Event

get

Returns Event object details (priority, event-type, event-data).

Enables a user to retrieve a file that is stored in the filestore. This is related to the "File" field type in the Metadata Designer. Files can be associated with the "File" field type, such as an image (thumbnail) or a JSON file.

get

Returns Event object details (priority, event-type, event-data).

Event Handlers

This resource is used for viewing and managing EventHandlers

get

Returns a list of EventHandlers. Listing is based on supplied filters.

Perform operations on a specific EventHandler

get

Returns EventHandler object details.

delete

Deletes the EventHandler

get

Returns a list of actions that can be performed.

post

Performs an action. Possible action types are - delete, destroy.

A collection of comment.

get

Returns a list of Comments.

post

Adds a new Comment.

Performs operations on a single Comment.

get

Returns a Comment.

post

Copies an existing Event Handler.

A collection of follower.

get

Returns a list of users that are following this object.

A collection of attachment.

get

Returns a list of attachments.

post

Creates a new attachment.

get

Returns the details for a specific attachment.

put

Updates the comment for an existing attachment.

delete

Deletes an existing attachment.

A collection of history.

get

Returns a list of events.

A collection of reference object links.

get

Returns a list of references.

Set or get the event configuration.

get

Returns the event handler configuration including a href to the configuration.

put

Updates the metadata instance associated with the configuration. A valid XML metadata structure is expected in the body. The updated metadata will be returned if the request was successful.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.

get

Returns the details for a specific external ID.

put

Updates the Account/System Property

delete

Deletes a specific external ID.

Files

Performs operations on non-asset files that are stored in the filestore.

get

Retrieves a non-asset file that is stored in the filestore. This includes attachments such as JSON files and images. You must use a GET request to obtain the file path name for the file Example- /api/versions/406690/data, then you can use the file path name to download the file. Example - api/files/3f9de7f0-f9a7-4141-a58f-6eda0518a15f.png.

Groups

Perform operation on Groups

get

Returns a list of Groups. Listing is based on supplied filters.

post

Creates a new Group.

Perform operations on a specific Group.

get

Returns Group object details.

put

Updates the group that the id belongs to.

delete

Deletes the Group

get

Returns a list of actions that can be performed.

post

Performs an action. Possible action types are - enable, disable, delete, retry, destroy.

A collection of comment.

get

Returns a list of Comments.

post

Adds a new Comment.

Performs operations on a single Comment.

get

Returns a Comment.

post

Copies an existing Group.

A collection of follower.

get

Returns a list of users that are following this object.

A collection of attachment.

get

Returns a list of attachments.

A collection of history.

get

Returns a list of events.

A collection of reference object links.

get

Returns a list of references.

get

Returns the metadata of a specific group.

put

Updates the metadata instance associated with the metadata. A valid XML metadata structure is expected in the body. The updated metadata will be returned if the request was successful.

Enables you to add a member to the group. You must also provide the IDs of all the other group members in order to add a new member. The same applies for updating any existing members. You must remove any member IDs if you want to remove those members from the group. Only available from 5.1.1 onwards.

get

Returns a list of users that are members of the specific role. Listing is based on supplied filters.

get

Returns a list of external IDs associated with an Account.

post

Creates new external ID.