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": {
    },
  • "text": "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
}

Batch Assets update

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 identifiers to be updated

required
object (PatchAssetToAssetType)

Payload containing the update details for the assets

Responses

Request samples

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

Export a list of assets in landingpad

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Carts

Create and manage Carts.

List Assets in a Cart

Authorizations:
customAuthorizer
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

embargoed
boolean

Filters Assets by is embargoed

quarantined
boolean

Filters Assets by is quarantined

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Count Items in a Cart

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
0
0

List Cart extra

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

List prices for a Cart

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

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

List of email addresses for delivery notifications

department_field_uuid
string
Array of objects

List of destination configurations, each with a unique identifier

discount_code
string

Optional discount code applied to the cart

download_limit
number

Maximum number of downloads allowed for this order

Array of objects (JobTypePayloadInterface)

List of jobs associated with the cart

order_type
string (OrderType)
Enum: "delivery_destination" "email_delivery" "workflow" "warm_up"

Type of order being placed

Responses

Request samples

Content type
application/json
{
  • "delivery_emails": [
    ],
  • "department_field_uuid": "string",
  • "destinations": [
    ],
  • "discount_code": "string",
  • "download_limit": 0,
  • "jobs": [
    ],
  • "order_type": "delivery_destination"
}

Response samples

Content type
application/json
{
  • "cold": 0,
  • "discount_name": "string",
  • "discount_prices": {
    },
  • "discount_status": "active",
  • "price": {
    },
  • "settings": {
    },
  • "total": 0
}

Validate Items in a Cart

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[ ]

Add search to a Cart

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"
}

Add to a Cart

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
Array
entity_uuid
required
string
object (PostOrderItemExtraInterface)
type
required
string (ItemTypeEnum)
Enum: "asset" "collection" "order"

Responses

Request samples

Content type
application/json
[
  • {
    }
]

Response samples

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

Delete Item from a Cart

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Response samples

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

Collections

Create and manage Collections

List Collections 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

filter
string

JSON encoded value of the filters

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List own collections 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

filter
string

JSON encoded value of the filters

Responses

List Shared Collections 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

filter
string

JSON encoded value of the filters

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get a Collection

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",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "items": [
    ],
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed": 0,
  • "owner": "string",
  • "owner_name": "string",
  • "shared_to_teams": [
    ],
  • "total": 0,
  • "updated_at": "2019-08-24T14:15:22Z",
  • "users": [
    ],
  • "uuid": "string"
}

Update a Collection

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
Array of objects (PatchCollectionItemType)

New collection collection items

custom_cover
boolean

An updated collection cover

delete_items
Array of strings

Collection items to delete

description
string

An updated collection description

filename
string

An updated collection filename

name
string

An updated collection name

owner
string

An updated collection owner

Array of objects (ParentCollectionInterface)

An updated collection parent

shared_to_team_uuids
Array of strings

An updated collection shared to team uuids

users
Array of strings

An updated collection users

Responses

Request samples

Content type
application/json
{
  • "add_items": [
    ],
  • "custom_cover": true,
  • "delete_items": [
    ],
  • "description": "string",
  • "filename": "string",
  • "name": "string",
  • "owner": "string",
  • "parentIds": [
    ],
  • "shared_to_team_uuids": [
    ],
  • "users": [
    ]
}

Response samples

Content type
application/json
{
  • "access_type": "shared",
  • "children": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed": 0,
  • "owner": "string",
  • "owner_name": "string",
  • "parent_uuids": [
    ],
  • "shared_to_teams": [
    ],
  • "updated_at": "2019-08-24T14:15:22Z",
  • "users": [
    ],
  • "uuid": "string"
}

Delete Collection

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

List collection items details

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

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

filter
string

JSON encoded value of the filters

tx-date-from
string

Filters results by newer than given date

tx-date-to
string

Filters results by older than given date

facility-of-origin
string

Filters results by facility of origin

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a Collection

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
description
required
string

A description of a new collection

name
required
string

A name for a new collection

uuid
required
string

An unique identifier for a new collection

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "access_type": "shared",
  • "children": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed": 0,
  • "owner": "string",
  • "owner_name": "string",
  • "parent_uuids": [
    ],
  • "shared_to_teams": [
    ],
  • "updated_at": "2019-08-24T14:15:22Z",
  • "users": [
    ],
  • "uuid": "string"
}

Export collection details

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

header Parameters
order-by
string

Set order by

order-dir
string

Set order dir

vida-client-id
string

Unique Client identifier in the system

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

Field names to export

Responses

Request samples

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

Get Access Type

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

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

Collection unique identifiers

Responses

Request samples

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

Response samples

Content type
application/json
[
  • {
    }
]

Upload a Collection

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
file_type
required
string

A filename for a new collection

file_uuid
required
string

An unique identifier for a new collection

filename
required
string

A filename for a new collection

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "access_type": "shared",
  • "children": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed": 0,
  • "owner": "string",
  • "owner_name": "string",
  • "parent_uuids": [
    ],
  • "shared_to_teams": [
    ],
  • "updated_at": "2019-08-24T14:15:22Z",
  • "users": [
    ],
  • "uuid": "string"
}

Create a Collection with confirmation

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
file_key
required
string

A file key of a new collection

filename
required
string

A filename of a new collection

Responses

Request samples

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

Response samples

Content type
application/json
"string"

Add order

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
order_uuid
required
string

An order uuid

Responses

Request samples

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

Add items to Collection

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 (PatchCollectionItemType)

New collection items data

Responses

Request samples

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

Add Cart Items to Collection

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

Add Collection to Cart

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

Add search results to Collection

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
collection_name
string

Collection name

collections
required
Array of strings

Collection list

required
object (PostSearchTypeV2)

A search query

users
Array of strings

Users unique identifier

Responses

Request samples

Content type
application/json
{
  • "collection_name": "string",
  • "collections": [
    ],
  • "query": {
    },
  • "users": [
    ]
}

Response samples

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

Remove items from Collection

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
items
required
Array of strings

Item unique identifiers

Responses

Request samples

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

Licensed Packages

Create and manage Licensed Packages.

List Licensed Packages

Authorizations:
customAuthorizer
query Parameters
contract_uuids
string

Filters Licensed Packages, List of contract unique identifiers

partner_uuids
string

Filters Licensed Packages, List of partners unique identifiers

expires_before
number

Filters Licensed Packages, Expires before that date

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

filter
string

JSON encoded value of the filters

status
string

Filters Licensed Packages, status can be draft or active

view-state
string

Filters Licensed Packages, view state can be none or promo or hero

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List Licensed Packages for Content Corner

Authorizations:
customAuthorizer
query Parameters
expires_before
number

Filters Licensed Packages, Expires before that date

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

filter
string

JSON encoded value of the filters

view-state
string

Filters Licensed Packages, view state can be none or promo or hero

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get a Licensed Package

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

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
{
  • "contracts": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "items": [
    ],
  • "max_expires_at": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed_assets": 0,
  • "options": {
    },
  • "owner": "string",
  • "owner_name": "string",
  • "status": "string",
  • "total": 0,
  • "updated_at": "2019-08-24T14:15:22Z",
  • "uuid": "string",
  • "view_state": "string"
}

Update a Licensed Package

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
contract_uuids
required
Array of strings

List of contract UUIDs associated with the licensed package

custom_cover
boolean

Indicates whether a custom cover is used

custom_cover_filename
string

Filename of the custom cover image

custom_cover_path
string

Path to the custom cover image

status
required
string (LicensedPackageStatus)
Enum: "draft" "active"

Status of the licensed package

Responses

Request samples

Content type
application/json
{
  • "contract_uuids": [
    ],
  • "custom_cover": true,
  • "custom_cover_filename": "string",
  • "custom_cover_path": "string",
  • "status": "draft"
}

Response samples

Content type
application/json
{
  • "contracts": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "items": [
    ],
  • "max_expires_at": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed_assets": 0,
  • "options": {
    },
  • "owner": "string",
  • "owner_name": "string",
  • "status": "string",
  • "total": 0,
  • "updated_at": "2019-08-24T14:15:22Z",
  • "uuid": "string",
  • "view_state": "string"
}

Delete a Licensed Package

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 a Licensed Package For Content Corner

Authorizations:
customAuthorizer
path Parameters
uuid
required
string

Unique item identifier in the system

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
{
  • "contracts": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "items": [
    ],
  • "max_expires_at": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed_assets": 0,
  • "options": {
    },
  • "owner": "string",
  • "owner_name": "string",
  • "status": "string",
  • "total": 0,
  • "updated_at": "2019-08-24T14:15:22Z",
  • "uuid": "string",
  • "view_state": "string"
}

List Licensed Package Items

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

downloaded
boolean

Filters Results by is downloaded

text
string

Filters results by included text

tx-date-from
string

Filters results by newer than given date

tx-date-to
string

Filters results by older than given date

type
string

Filters results by asset type

Available asset types:

video, audio, image, subtitle, archive, document, other, font

facility-of-origin
string

Filters results by facility of origin

Responses

Response samples

Content type
application/json
[
  • {
    }
]

List Licensed Package Items for Content Corner

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

downloaded
boolean

Filters Results by is downloaded

text
string

Filters results by included text

tx-date-from
string

Filters results by newer than given date

tx-date-to
string

Filters results by older than given date

type
string

Filters results by asset type

Available asset types:

video, audio, image, subtitle, archive, document, other, font

facility-of-origin
string

Filters results by facility of origin

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a Licensed Package

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
description
required
string

Description of the licensed package

name
required
string

Name of the licensed package

required
object (LicensedPackageOptions)

Options and settings for the licensed package

view_state
required
string (LicensedPackageViewStateType)
Enum: "none" "promo" "hero"

Current view state of the licensed package

Responses

Request samples

Content type
application/json
{
  • "description": "string",
  • "name": "string",
  • "options": {
    },
  • "view_state": "none"
}

Response samples

Content type
application/json
{
  • "contracts": [
    ],
  • "created_at": "2019-08-24T14:15:22Z",
  • "custom_cover": true,
  • "custom_cover_path": "string",
  • "description": "string",
  • "items": [
    ],
  • "max_expires_at": "string",
  • "name": "string",
  • "number_of_assets": 0,
  • "number_of_embargoed_assets": 0,
  • "options": {
    },
  • "owner": "string",
  • "owner_name": "string",
  • "status": "string",
  • "total": 0,
  • "updated_at": "2019-08-24T14:15:22Z",
  • "uuid": "string",
  • "view_state": "string"
}

Download Setup for a Licensed Package

Creates a download setup for a Licensed Package or a download setup for Licensed Package Items if Asset uuids or Licensed Package Item uuids are given.

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
download_asset_uuids
Array of strings

List of asset UUIDs for the downloaded

download_uuids
Array of strings

List of licensed packages UUIDs for the download

keep_folders_structure
boolean

Indicates whether to preserve the folder structure during download

partner_uuid
required
string

UUID of the partner initiating the download

required
object (PostSearchTypeV2)

Search criteria for selecting licensed packages to download

Responses

Request samples

Content type
application/json
{
  • "download_asset_uuids": [
    ],
  • "download_uuids": [
    ],
  • "keep_folders_structure": true,
  • "partner_uuid": "string",
  • "search": {
    }
}

Response samples

Content type
application/json
{
  • "cookie": "string",
  • "faspPort": 0,
  • "paths": [
    ],
  • "remoteHost": "string",
  • "remoteUser": "string",
  • "sshPort": 0,
  • "token": "string",
  • "transferUuid": "string"
}

List Licensed Package Partners

Returns list of a valid Partners for a Licensed Package with the information if the Partner can still download this LicensedPackage. Download availability is based on Download Limit. If anything can be downloaded from Licensed Package canBeDownloaded will be return as true.

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
asset_uuids
Array of strings

List of asset UUIDs that will be downloaded

Responses

Request samples

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

Response samples

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

Trigger Notification for a Licensed Package

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

Add items to Licensed Package

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 (PatchLicensedPackageItemType)

List of asset uuids and notes

Responses

Request samples

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

Add Search Licensed Packages

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
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"
}

Delete items form Licensed Package

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
items
required
Array of strings

Responses

Request samples

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

Orders

Create and manage Orders.

List Orders

Authorizations:
customAuthorizer
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

status
string

Filters by order status, can be submitted or approved

delivery-status
string

Filters orders by delivery-status

Available delivery statuses:

  • created

  • scheduled

  • collecting_assets

  • delivery

  • delivered

  • failed

  • submitted_to_sf

  • gettyimages_api_failed

  • retrieving_from_cold

orders-type
string

Filters orders by its typeAvailable order types:

  • shared-packs

  • all

  • shared

  • own

name-subject
string
download-status
string

Filters orders by download-status, can be new or downloaded or expired

date-from
string

Filters results by newer than given date

date-to
string

Filters results by older than given date

Responses

Response samples

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

Get an Order

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

Edit an Order

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
comment
string

Optional comment for the order

expires_at
number

The expiration date of the order

send_as_shared_pack
required
boolean

Indicates whether the order should be sent as a shared pack

sf_unlock
boolean
status
required
string
Enum: "approved" "submitted"

Status of the order

Responses

Request samples

Content type
application/json
{
  • "comment": "string",
  • "expires_at": 0,
  • "send_as_shared_pack": true,
  • "sf_unlock": true,
  • "status": "approved"
}

Response samples

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

List items for an Order

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

downloaded
boolean

Filters Results by is downloaded

text
string

Filters results by included text

tx-date-from
string

Filters results by newer than given date

tx-date-to
string

Filters results by older than given date

type
string

Filters results by asset type

Available asset types:

video, audio, image, subtitle, archive, document, other, font

facility-of-origin
string

Filters results by facility of origin

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Edit Order Items

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

A list of assets with their unique identifiers and status

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 an Order confirmation pdf

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 Redelivery Emails

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"
]

List an Order related emails

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
[
  • "string"
]

List orders from a Mediapulse

Authorizations:
customAuthorizer
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

text
string

Filters results by included text

po
string

Filters mediapulse orders by purchase number

wo_no
string

Filters mediapulse orders by identifier

tx-date-from
string

Filters results by newer than given date

tx-date-to
string

Filters results by older than given date

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create an Order

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Responses

Response samples

Content type
application/json
{
  • "coldStorageRetrieval": true,
  • "id": 0,
  • "uuid": "string"
}

Download setup for an Order

Creates a download setup for an Order or a download setup for Order Items if Order Items uuids are given.

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
config_uuid
required
string

The configuration UUID for the download request

download_uuids
required
Array of strings

A list of UUIDs for the files to be downloaded

keep_folders_structure
boolean

Flag indicating whether to keep the folder structure during the download

Responses

Request samples

Content type
application/json
{
  • "config_uuid": "string",
  • "download_uuids": [
    ],
  • "keep_folders_structure": true
}

Response samples

Content type
application/json
{
  • "cookie": "string",
  • "faspPort": 0,
  • "paths": [
    ],
  • "remoteHost": "string",
  • "remoteUser": "string",
  • "sshPort": 0,
  • "token": "string",
  • "transferUuid": "string"
}

Retry Clipping

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
items
required
Array of strings

A list of item UUIDs to re-trigger clipping

Responses

Request samples

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

Response samples

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

Retry Delivery Destinations Failed Jobs

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 (OrderRetryDDJobInterface)

A list of jobs to retry

Responses

Request samples

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

Response samples

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

Retry delivery for 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
emails
required
Array of strings

List of email addresses for redelivering the clips

Responses

Request samples

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

Response samples

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

Get an Order delivery confirmation pdf

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 Order delivery confirmation pdfs

Pdfs are being send by an email to an User

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

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

A list of UUIDs to get order delivery confirmation pdfs

Responses

Request samples

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

Set Aspera Download Success Status

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
status
required
string
Enum: "completed" "error" "success"

The aspera finished status of the download.

transferUuid
required
string

The unique identifier for the aspera transfer

Responses

Request samples

Content type
application/json
{
  • "status": "completed",
  • "transferUuid": "string"
}

Export an Order details

Authorizations:
customAuthorizer
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

status
string
delivery-status
string

Filters orders by delivery-status

Available delivery statuses:

  • created

  • scheduled

  • collecting_assets

  • delivery

  • delivered

  • failed

  • submitted_to_sf

  • gettyimages_api_failed

  • retrieving_from_cold

orders-type
string

Filters orders by its typeAvailable order types:

  • shared-packs

  • all

  • shared

  • own

name-subject
string
download-status
string

Filters orders by download-status, can be new or downloaded or expired

date-from
string

Filters results by newer than given date

date-to
string

Filters results by older than given date

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

Responses

Request samples

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

Response samples

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

Convert pathe to uuid

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

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

A list of path IDs

Responses

Request samples

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

Response samples

Content type
application/json
{ }

Order again

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
{
  • "code": 0,
  • "data": null,
  • "message": "string",
  • "name": "string",
  • "stack": "string"
}

Rights Contracts

Create and manage Rights Contracts.

List Rights Contracts

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

partner-id
string

Filter results by Partner identifier

filter
string

JSON encoded value of the filters

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Get a Rights Contract

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
{
  • "contract_id": "string",
  • "created_at": "string",
  • "download_limit": 0,
  • "end_date": "string",
  • "licensed_package_count": 0,
  • "licensed_package_names": [
    ],
  • "licensed_package_uuids": [
    ],
  • "name": "string",
  • "notifications_enabled": true,
  • "partner": {
    },
  • "start_date": "string",
  • "status": "string",
  • "updated_at": "string",
  • "uuid": "string"
}

Update a Rights Contract

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
contract_id
required
string

Contract identifier

created_at
required
string

Timestamp when the rights contract was created

download_limit
required
number

A number of times an item can be downloaded per contract

end_date
required
string

End date of the rights contract

licensed_package_count
required
number

Count of licensed packages associated with the rights contract

licensed_package_names
required
Array of strings

List of names for licensed packages associated with the rights contract

licensed_package_uuids
required
Array of strings

List of UUIDs for licensed packages associated with the rights contract

licensed_packages_to_attach
required
Array of strings

List of licensed package UUIDs to attach to the rights contract

licensed_packages_to_detach
required
Array of strings

List of licensed package UUIDs to detach from the rights contract

name
required
string

Name of the rights contract

notifications_enabled
required
boolean

Flag indicating if notifications are enabled for the contract

required
object

Partner details including UUID, name, and users count

partner_uuid
required
string

UUID of the partner associated with the rights contract

start_date
required
string

Start date of the rights contract

status
required
string

Current status of the rights contract

updated_at
required
string

Timestamp when the rights contract was last updated

Responses

Request samples

Content type
application/json
{
  • "contract_id": "string",
  • "created_at": "string",
  • "download_limit": 0,
  • "end_date": "string",
  • "licensed_package_count": 0,
  • "licensed_package_names": [
    ],
  • "licensed_package_uuids": [
    ],
  • "licensed_packages_to_attach": [
    ],
  • "licensed_packages_to_detach": [
    ],
  • "name": "string",
  • "notifications_enabled": true,
  • "partner": {
    },
  • "partner_uuid": "string",
  • "start_date": "string",
  • "status": "string",
  • "updated_at": "string"
}

Response samples

Content type
application/json
{
  • "contract_id": "string",
  • "created_at": "string",
  • "download_limit": 0,
  • "end_date": "string",
  • "licensed_package_count": 0,
  • "licensed_package_names": [
    ],
  • "licensed_package_uuids": [
    ],
  • "name": "string",
  • "notifications_enabled": true,
  • "partner": {
    },
  • "start_date": "string",
  • "status": "string",
  • "updated_at": "string",
  • "uuid": "string"
}

Delete a Rights Contract

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 Rights Contract 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

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Create a Rights Contract

Authorizations:
customAuthorizer
header Parameters
vida-client-id
string

Unique Client identifier in the system

Request Body schema: application/json
required
contract_id
required
string

Contract identifier

download_limit
required
number

A number of times an item can be downloaded per contract

end_date
required
string

End date of the rights contract

licensed_package_uuids
required
Array of strings

List of UUIDs for licensed packages associated with the rights contract

name
required
string

Name of the rights contract

notifications_enabled
required
boolean

Flag indicating if notifications are enabled for the contract

partner_uuid
required
string

UUID of the partner associated with the rights contract

start_date
required
string

Start date of the rights contract

uuid
required
string

Unique identifier for the rights contract

Responses

Request samples

Content type
application/json
{
  • "contract_id": "string",
  • "download_limit": 0,
  • "end_date": "string",
  • "licensed_package_uuids": [
    ],
  • "name": "string",
  • "notifications_enabled": true,
  • "partner_uuid": "string",
  • "start_date": "string",
  • "uuid": "string"
}

Response samples

Content type
application/json
{
  • "contract_id": "string",
  • "created_at": "string",
  • "download_limit": 0,
  • "end_date": "string",
  • "licensed_package_count": 0,
  • "licensed_package_names": [
    ],
  • "licensed_package_uuids": [
    ],
  • "name": "string",
  • "notifications_enabled": true,
  • "partner": {
    },
  • "start_date": "string",
  • "status": "string",
  • "updated_at": "string",
  • "uuid": "string"
}

Export a Rights Contract 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

partner-id
string

Partner identifier

filter
string

JSON encoded value of the filters

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

Responses

Request samples

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

Set a Rights Contract to release

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
{
  • "contract_id": "string",
  • "created_at": "string",
  • "download_limit": 0,
  • "end_date": "string",
  • "licensed_package_count": 0,
  • "licensed_package_names": [
    ],
  • "licensed_package_uuids": [
    ],
  • "name": "string",
  • "notifications_enabled": true,
  • "partner": {
    },
  • "start_date": "string",
  • "status": "string",
  • "updated_at": "string",
  • "uuid": "string"
}