VIDA Backend API (1.0.0)

Download OpenAPI specification:Download

Welcome to the Vida API

The Vida API allows seamless integration with your media asset management process, from ingesting assets to handling complex delivery configurations. Every aspect of media management can be controlled through the Vida RESTful API, offering the flexibility and scalability to meet the needs of content creators, broadcasters, and media distributors. With automation, secure architecture, and AI-driven tools, Vida enhances every step of your media workflow.

Authentication

Vida uses OAuth-based authentication through Google or Microsoft, with multi-factor authentication (MFA) available for added security. Include your access token in the Authorization header for each request.

Assets

Create and manage Assets.

Get details for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "additional": {
    },
  • "attachments": [
    ],
  • "audioTracks": [
    ],
  • "core": {
    },
  • "ext_asset_info": {
    },
  • "ext_title_info": {
    },
  • "file_metadata": {
    },
  • "general": {
    },
  • "locks": [
    ],
  • "logginginfo": [
    ],
  • "mediaset": {
    },
  • "transactions": [
    ],
  • "user_media_data": {
    }
}

Update an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
object (PatchAssetAdditionalType)
Array of objects (PatchAssetAudioTrackType)
object (PatchAssetCoreType)
object (PatchAssetExtAssetInfoType)
object (PatchAssetExtTitleInfoType)
object (PatchAssetGeneralType)
object (PatchAssetMediaSetType)
object (PatchAssetUserMediaDataType)

Responses

Request samples

Content type
application/json
{
  • "additional": {
    },
  • "audioTracks": [
    ],
  • "core": {
    },
  • "ext_asset_info": {
    },
  • "ext_title_info": {
    },
  • "general": {
    },
  • "mediaset": {
    },
  • "user_media_data": {
    }
}

Response samples

Content type
application/json
{
  • "additional": {
    },
  • "attachments": [
    ],
  • "audioTracks": [
    ],
  • "core": {
    },
  • "ext_asset_info": {
    },
  • "ext_title_info": {
    },
  • "file_metadata": {
    },
  • "general": {
    },
  • "locks": [
    ],
  • "logginginfo": [
    ],
  • "mediaset": {
    },
  • "transactions": [
    ],
  • "user_media_data": {
    }
}

Delete an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
assetUuids
required
Array of strings
deleteReason
required
string
deletionBillable
required
boolean

Responses

Request samples

Content type
application/json
{
  • "assetUuids": [
    ],
  • "deleteReason": "string",
  • "deletionBillable": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

Get subtitles for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "subs": [
    ]
}

Get a Hybrik Analyze for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "deep_properties": {
    },
  • "general_properties": {
    },
  • "hybrik_profile": {
    }
}

Get a playlist for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
"string"

Get a Hybrik QA for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Get pdf with an Asset details

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "url": "string"
}

List Asset Storage Logs

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

order-by
string

Set order by

order-dir
string

Set order dir

page
number

Set page

per-page
number

Set items per page

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List an Asset Storage Statuses

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "s3Status": "string",
  • "wasabiStatus": "string"
}

Get transcriptions for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Upload to Vimeo

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "link": "string",
  • "uri": "string"
}

Get historical asset locks which represent successful edits by users

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get details of before / after state of the asset lock

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "after": [
    ],
  • "before": [
    ]
}

Lock an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

type
required
string

Type of data to be locked for edits

confirm
boolean

Confirm take over of existing lock by another user

action
required
string

Action to perform with lock. Can be create or refresh or unlock

Responses

Response samples

Content type
application/json
{
  • "asset_uuid": "string",
  • "expires": "string",
  • "lock_uuid": "string",
  • "type": "AI_JOB_EDIT",
  • "user_uuid": "string"
}

Create an Asset

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Add a File to an Asset from Aspera

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
batchId
required
string

Batch identifier

internalFilename
required
string

Internal filename used within the system for the asset

originalFilename
required
string

Original filename of the asset

sourcePath
required
string

Source path where the asset is stored

Responses

Request samples

Content type
application/json
{
  • "batchId": "string",
  • "internalFilename": "string",
  • "originalFilename": "string",
  • "sourcePath": "string"
}

Response samples

Content type
application/json
{
  • "cookie": "string",
  • "destinationRoot": "string",
  • "token": "string"
}

Get download proxy for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
contact_name
string

Name of the contact associated with the download proxy

contact_uuid
string

UUID of the contact associated with the download proxy

opportunity_name
string

Name of the opportunity associated with the download proxy

opportunity_uuid
string

UUID of the opportunity associated with the download proxy

Responses

Request samples

Content type
application/json
{
  • "contact_name": "string",
  • "contact_uuid": "string",
  • "opportunity_name": "string",
  • "opportunity_uuid": "string"
}

Response samples

Content type
application/json
{
  • "url": "string"
}

Register to Rasp

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "created_at": "2019-08-24T14:15:22Z",
  • "expired_at": "2019-08-24T14:15:22Z",
  • "ruid": "string"
}

Delete from a Rasp register

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Create an Asset Trailer

Trailer is created from asset clips.

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
imgCount
required
number

The number of images or clips to be used for the trailer

Responses

Request samples

Content type
application/json
{
  • "imgCount": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

Create an Asset Trailer

Trailer is created from images.

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
imgCount
required
number

The number of images or clips to be used for the trailer

Responses

Request samples

Content type
application/json
{
  • "imgCount": 0
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

Create transcription for an Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
modelUuid
required
string

Unique identifier for the model associated with the job

object

Optional job options, including tone settings

trackNumber
string

Optional track number associated with the job

Responses

Request samples

Content type
application/json
{
  • "modelUuid": "string",
  • "options": {
    },
  • "trackNumber": "string"
}

Response samples

Content type
application/json
{
  • "jobUuid": "string"
}

Abort an upload

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
uploadId
required
string

Unique identifier for the upload session to be aborted

Responses

Request samples

Content type
application/json
{
  • "uploadId": "string"
}

Complete an upload

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
required
Array of objects (UploadAssetCompletePart)

List of uploaded parts

uploadId
required
string

The ID of the upload session

Responses

Request samples

Content type
application/json
{
  • "parts": [
    ],
  • "uploadId": "string"
}

Create an upload

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
partNumber
required
number

The part number of the uploaded

uploadId
required
string

Unique identifier for the upload

Responses

Request samples

Content type
application/json
{
  • "partNumber": 0,
  • "uploadId": "string"
}

Response samples

Content type
application/json
"string"

Create a Virtual Asset

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
timecodeIn
required
string

Starting timecode for the virtual asset

timecodeOut
required
string

Ending timecode for the virtual asset

Responses

Request samples

Content type
application/json
{
  • "timecodeIn": "string",
  • "timecodeOut": "string"
}

Response samples

Content type
application/json
{
  • "uuid": "string"
}

Create an Asset from Aspera

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
required
Array of objects (PostAsperaAssetToAssetTypeFiles)

List of files for aspera

Responses

Request samples

Content type
application/json
{
  • "files": [
    ]
}

Response samples

Content type
application/json
{
  • "cookie": "string",
  • "destinationRoot": "string",
  • "token": "string"
}

Update an Asset embargo date

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
object (PatchAssetAdditionalType)
Array of objects (PatchAssetAudioTrackType)
object (PatchAssetCoreType)
object (PatchAssetExtAssetInfoType)
object (PatchAssetExtTitleInfoType)
object (PatchAssetGeneralType)
object (PatchAssetMediaSetType)
object (PatchAssetUserMediaDataType)

Responses

Request samples

Content type
application/json
{
  • "additional": {
    },
  • "audioTracks": [
    ],
  • "core": {
    },
  • "ext_asset_info": {
    },
  • "ext_title_info": {
    },
  • "general": {
    },
  • "mediaset": {
    },
  • "user_media_data": {
    }
}

Response samples

Content type
application/json
true

Regenerate an Asset Proxy

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
true

Finish an Aspera Upload

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
batch_id
required
string

Batch identifier

is_reuploaded
required
boolean

Flag indicating whether the asset has been re-uploaded

Responses

Request samples

Content type
application/json
{
  • "batch_id": "string",
  • "is_reuploaded": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

List Assets details

Authorizations:
customAuthorizer
header Parameters
order-by
string

Set order by

order-dir
string

Set order dir

page
number

Set page

per-page
number

Set items per page

vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Assets update

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
filename
required
string

File name

Responses

Request samples

Content type
application/json
{
  • "filename": "string"
}

Response samples

Content type
application/json
{
  • "key": "string",
  • "policy": "string",
  • "url": "string",
  • "x_amz_algorithm": "string",
  • "x_amz_credential": "string",
  • "x_amz_date": "string",
  • "x_amz_security_token": "string",
  • "x_amz_signature": "string"
}

Delete Assets

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
assetUuids
required
Array of strings
deleteReason
required
string
deletionBillable
required
boolean

Responses

Request samples

Content type
application/json
{
  • "assetUuids": [
    ],
  • "deleteReason": "string",
  • "deletionBillable": true
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

List All Assets

Authorizations:
customAuthorizer
header Parameters
Cache-Control
object

Overrides default cache behaviour.

order-by
string

Set order by

order-dir
string

Set order dir

page
number

Set page

per-page
number

Set items per page

vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Archived Assets

Authorizations:
customAuthorizer
header Parameters
Cache-Control
object

Overrides default cache behaviour.

order-by
string

Set order by

order-dir
string

Set order dir

page
number

Set page

per-page
number

Set items per page

vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get Ingest Assets List

Authorizations:
customAuthorizer
header Parameters
Cache-Control
object

Overrides default cache behaviour.

order-by
string

Set order by

order-dir
string

Set order dir

page
number

Set page

per-page
number

Set items per page

vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List latest Assets

Authorizations:
customAuthorizer
header Parameters
order-by
string

Set order by

order-dir
string

Set order dir

page
number

Set page

per-page
number

Set items per page

vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Generate Mediapulse JSON for Assets

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "message": "Accepted"
}

List All Assets on map

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
polyenc
required
string

Assets Poly

Responses

Request samples

Content type
application/json
{
  • "polyenc": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

Set Assets as Cold

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
assets
required
Array of strings

List of asset uuids

Responses

Request samples

Content type
application/json
{
  • "assets": [
    ]
}

Response samples

Content type
application/json
true

Set Search Assets as cold

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
advanced_mode
boolean

Flag indicating whether advanced search mode is enabled

discount_code
string
fields
Array of strings

List of specific fields to include in the search results

object (AssetSearchFiltersTypeV2)

Filters applied to narrow down the search results

text
string

Text input for searching assets

Responses

Request samples

Content type
application/json
{
  • "advanced_mode": true,
  • "discount_code": "string",
  • "fields": [
    ],
  • "filters": {
    },
  • "text": "string"
}

Response samples

Content type
application/json
true

Set assets as hot

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
assets
required
Array of strings

List of asset uuids

Responses

Request samples

Content type
application/json
{
  • "assets": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

Get price for set as hot/cold

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
assets
required
Array of strings

List of asset uuids

department_field_uuid
string
discount_code
string

Optional discount code to apply to the search

Responses

Request samples

Content type
application/json
{
  • "assets": [
    ],
  • "department_field_uuid": "string",
  • "discount_code": "string"
}

Response samples

Content type
application/json
{
  • "currency": "string",
  • "discount_name": "string",
  • "discount_prices": {
    },
  • "discount_status": "active",
  • "price_per_gb": 0,
  • "total_assets": 0,
  • "total_bytes": 0,
  • "total_price": 0
}

Set Search Assets as hot

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
advanced_mode
boolean

Flag indicating whether advanced search mode is enabled

discount_code
string
fields
Array of strings

List of specific fields to include in the search results

object (AssetSearchFiltersTypeV2)

Filters applied to narrow down the search results

text
string

Text input for searching assets

Responses

Request samples

Content type
application/json
{
  • "advanced_mode": true,
  • "discount_code": "string",
  • "fields": [
    ],
  • "filters": {
    },
  • "text": "string"
}

Response samples

Content type
application/json
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

Get price for set as hot/cold from search

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
advanced_mode
boolean

Flag indicating whether advanced search mode is enabled

department_field_uuid
string
discount_code
string

Optional discount code to apply to the search

fields
Array of strings

List of specific fields to include in the search results

object (AssetSearchFiltersTypeV2)

Filters applied to narrow down the search results

text
string

Text input for searching assets

Responses

Request samples

Content type
application/json
{
  • "advanced_mode": true,
  • "department_field_uuid": "string",
  • "discount_code": "string",
  • "fields": [
    ],
  • "filters": {