# Video
> Type in domain **Assets**
- HTML: [Video.html](Video.html)
- Raw SDL: [Video.sdl](Video.sdl)
- Covered by: [llms.txt](../llms.txt)
Implements: `Node`, `Asset`
## Fields
- `id`: `ID!` — `Asset` id.
- `creator`: `User!` — The `User` who created the `Asset`.
- `createdAt`: `DateTime!` — `DateTime` of the `Asset` creation.
- `modifier`: `User` — The `User` who last modified the `Asset`.
- `modifiedAt`: `DateTime` — `DateTime` of the `Asset` last modification.
- `title`: `String!` — Title of the `Asset`.
- `description`: `String` — Description of the `Asset`.
- `alternativeText`: `String` — Alternative text for the `Asset`. Used by screen readers when the asset is not decorative.
- `isDecorative`: `Boolean!` — Indicates whether the `Asset` is decorative and not meant to be read by screen readers. If true, alternative text is ignored.
- `externalId`: `ID` — External Id of the `Asset`.
- `tags`: `[Tag]` — List of `Tag` items linked to `Asset`
- `metadataValues`: `[MetadataValue]` _(deprecated)_ — `MetadataValue` items linked to `Asset`.
- `copyright`: `Copyright` — `Asset` copyright details.
- `availability`: `DateTimeRange!` — `Asset` will be available only during the defined `DateTime` range. When `null` it represents an unspecified start and/or open-ended date.
- `expiresAt`: `DateTime` — `Asset` available until date.
- `author`: `String` — Represents the Author of the `Asset`. Example: Photographer Name.
- `status`: `AssetStatusType!` — Represents the conversion status of the `Asset`. Example: FINISHED.
- `relatedAssets` (`limit`: `Int`, `page`: `Int`): `AssetItems!` — Paginated list of `Asset` items related to `Asset`.
- `revisions` (`limit`: `Int`, `page`: `Int`): `AssetRevisionItems!` — Paginated list of `AssetRevision` items for `Asset`, newest first.
- `comments` (`limit`: `Int`, `page`: `Int`, `query`: `AssetCommentQueryInput`): `AssetCommentItems` — Paginated list of `AssetComment` items for `Asset`.
- `currentUserPermissions`: `AssetUserPermissions!` — Current `User` `Asset` permissions.
- `customMetadata`: `[CustomMetadata!]!` — List of `CustomMetadataProperty` items and values associated to `Asset`.
- `workflowTask`: `WorkflowTask` _(beta)_ — The `WorkflowTask` this `Asset` is linked to.
- `variants` (`limit`: `Int`, `page`: `Int`): `AssetVariantItems` — `AssetVariant` items of the asset. Only available for assets in icon and logo libraries.
- `location`: `AssetLocation!` — `Location` of the `Asset`.
- `previewBackgroundColor`: `RgbaColor` _(beta)_ — Background color of the `Asset` preview.
- `filename`: `String` — Original filename of the `Asset` `File`.
- `size`: `BigInt` — Size of the `Asset` `File` in bytes.
- `extension`: `String!` — Extension of the `Asset` `File`.
- `fileCreatedAt`: `DateTime` — `DateTime` of the `Asset` `File` creation.
- `previewUrl` (`width`: `Int`, `height`: `Int`): `Url!` — Preview `Url` of converted `Video` in mp4 format.
- `thumbnailUrl`: `Url` — Provides a `Url` for the custom user defined thumbnail or a system generated one when possible.
- `downloadUrl` (`validityInDays`: `Int`, `permanent`: `Boolean`): `Url` — Signed `Url` to download the original `Video` type file. Is null if the asset is download-protected and there is no approved and still valid download request.
- `width`: `Int!` — `Video` width in pixels.
- `height`: `Int!` — `Video` height in pixels.
- `duration`: `Float!` — `Video` duration in seconds.
- `bitrate`: `Int!` — `Video` bitrate in bits per second.
- `attachments`: `[AssetAttachment]` — `Attachment` items linked to `Asset`.
- `provenance`: `AssetProvenance` _(beta)_ — AI provenance read from the asset's current file, or `null` if none has been extracted yet.
- `licenses`: `[License]` — `License` items linked to `Asset`.
- `targets`: `[Target]` _(beta)_ — List of `Target` related to `Asset`
## Reach via
Example queries that can return this type from the root `Query`.
### `assets`
```graphql
query Assets {
assets(ids: "…") {
... on Video {
__typename
alternativeText
attachments {
name
filename
id
createdAt
downloadUrl
extension
creator {
__typename
name
id
}
modifier {
__typename
name
id
}
}
author
availability {
from
to
}
bitrate
comments {
total
page
limit
hasNextPage
items {
id
content
createdAt
isResolved
creator { id }
currentUserPermissions { canDelete }
}
}
copyright {
notice
status
}
createdAt
creator {
__typename
name
id
}
currentUserPermissions {
canComment
canDelete
canDownload
canEdit
}
customMetadata {
__typename
property {
name
id
createdAt
defaultValue
creator { id }
dependency { propertyId }
}
... on CustomMetadataValue {
value
}
... on CustomMetadataValues {
values
}
}
description
downloadUrl
duration
expiresAt
extension
externalId
fileCreatedAt
filename
height
id
isDecorative
licenses {
title
id
addByDefault
license
requireConsensus
}
location {
brand {
name
id
}
folder {
name
id
breadcrumbs { id }
}
library {
name
id
}
workspaceProject {
name
id
}
}
modifiedAt
modifier {
__typename
name
id
}
previewBackgroundColor {
alpha
blue
green
red
}
previewUrl
provenance {
certExpiresAt
certIssuedAt
certIssuer
certStatus
certSubject
contentOrigin
}
relatedAssets {
total
page
limit
hasNextPage
items {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
}
revisions {
total
page
limit
hasNextPage
items {
id
createdAt
creator { id }
}
}
size
status
tags {
source
value
}
targets {
name
id
}
thumbnailUrl
title
variants {
total
page
limit
hasNextPage
items {
filename
downloadUrl
key
}
}
width
workflowTask {
title
id
description
asset {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
assignedUsers {
__typename
name
id
}
checklistItem {
total
page
limit
hasNextPage
items { id }
}
status {
name
id
enterRules
assignedUsers { id }
checklistPresets { id }
}
}
}
}
}
```
Raw: [`Assets-Video.sdl`](../examples/Assets-Video.sdl)
### `asset`
```graphql
query Asset {
asset(id: "…") {
... on Video {
__typename
alternativeText
attachments {
name
filename
id
createdAt
downloadUrl
extension
creator {
__typename
name
id
}
modifier {
__typename
name
id
}
}
author
availability {
from
to
}
bitrate
comments {
total
page
limit
hasNextPage
items {
id
content
createdAt
isResolved
creator { id }
currentUserPermissions { canDelete }
}
}
copyright {
notice
status
}
createdAt
creator {
__typename
name
id
}
currentUserPermissions {
canComment
canDelete
canDownload
canEdit
}
customMetadata {
__typename
property {
name
id
createdAt
defaultValue
creator { id }
dependency { propertyId }
}
... on CustomMetadataValue {
value
}
... on CustomMetadataValues {
values
}
}
description
downloadUrl
duration
expiresAt
extension
externalId
fileCreatedAt
filename
height
id
isDecorative
licenses {
title
id
addByDefault
license
requireConsensus
}
location {
brand {
name
id
}
folder {
name
id
breadcrumbs { id }
}
library {
name
id
}
workspaceProject {
name
id
}
}
modifiedAt
modifier {
__typename
name
id
}
previewBackgroundColor {
alpha
blue
green
red
}
previewUrl
provenance {
certExpiresAt
certIssuedAt
certIssuer
certStatus
certSubject
contentOrigin
}
relatedAssets {
total
page
limit
hasNextPage
items {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
}
revisions {
total
page
limit
hasNextPage
items {
id
createdAt
creator { id }
}
}
size
status
tags {
source
value
}
targets {
name
id
}
thumbnailUrl
title
variants {
total
page
limit
hasNextPage
items {
filename
downloadUrl
key
}
}
width
workflowTask {
title
id
description
asset {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
assignedUsers {
__typename
name
id
}
checklistItem {
total
page
limit
hasNextPage
items { id }
}
status {
name
id
enterRules
assignedUsers { id }
checklistPresets { id }
}
}
}
}
}
```
Raw: [`Asset-Video.sdl`](../examples/Asset-Video.sdl)
### `account › search`
```graphql
query AccountSearch {
account {
search(limit: 25, page: 1) {
items {
... on Video {
__typename
alternativeText
attachments {
name
filename
id
createdAt
downloadUrl
extension
creator {
__typename
name
id
}
modifier {
__typename
name
id
}
}
author
availability {
from
to
}
bitrate
comments {
total
page
limit
hasNextPage
items {
id
content
createdAt
isResolved
creator { id }
currentUserPermissions { canDelete }
}
}
copyright {
notice
status
}
createdAt
creator {
__typename
name
id
}
currentUserPermissions {
canComment
canDelete
canDownload
canEdit
}
customMetadata {
__typename
property {
name
id
createdAt
defaultValue
creator { id }
dependency { propertyId }
}
... on CustomMetadataValue {
value
}
... on CustomMetadataValues {
values
}
}
description
downloadUrl
duration
expiresAt
extension
externalId
fileCreatedAt
filename
height
id
isDecorative
licenses {
title
id
addByDefault
license
requireConsensus
}
location {
brand {
name
id
}
folder {
name
id
breadcrumbs { id }
}
library {
name
id
}
workspaceProject {
name
id
}
}
modifiedAt
modifier {
__typename
name
id
}
previewBackgroundColor {
alpha
blue
green
red
}
previewUrl
provenance {
certExpiresAt
certIssuedAt
certIssuer
certStatus
certSubject
contentOrigin
}
relatedAssets {
total
page
limit
hasNextPage
items {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
}
revisions {
total
page
limit
hasNextPage
items {
id
createdAt
creator { id }
}
}
size
status
tags {
source
value
}
targets {
name
id
}
thumbnailUrl
title
variants {
total
page
limit
hasNextPage
items {
filename
downloadUrl
key
}
}
width
workflowTask {
title
id
description
asset {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
assignedUsers {
__typename
name
id
}
checklistItem {
total
page
limit
hasNextPage
items { id }
}
status {
name
id
enterRules
assignedUsers { id }
checklistPresets { id }
}
}
}
}
}
}
}
```
Raw: [`AccountSearch-Video.sdl`](../examples/AccountSearch-Video.sdl)
### `assets › relatedAssets`
```graphql
query AssetsRelatedAssets {
assets(ids: "…") {
relatedAssets(limit: 25, page: 1) {
items {
... on Video {
__typename
alternativeText
attachments {
name
filename
id
createdAt
downloadUrl
extension
creator {
__typename
name
id
}
modifier {
__typename
name
id
}
}
author
availability {
from
to
}
bitrate
comments {
total
page
limit
hasNextPage
items {
id
content
createdAt
isResolved
creator { id }
currentUserPermissions { canDelete }
}
}
copyright {
notice
status
}
createdAt
creator {
__typename
name
id
}
currentUserPermissions {
canComment
canDelete
canDownload
canEdit
}
customMetadata {
__typename
property {
name
id
createdAt
defaultValue
creator { id }
dependency { propertyId }
}
... on CustomMetadataValue {
value
}
... on CustomMetadataValues {
values
}
}
description
downloadUrl
duration
expiresAt
extension
externalId
fileCreatedAt
filename
height
id
isDecorative
licenses {
title
id
addByDefault
license
requireConsensus
}
location {
brand {
name
id
}
folder {
name
id
breadcrumbs { id }
}
library {
name
id
}
workspaceProject {
name
id
}
}
modifiedAt
modifier {
__typename
name
id
}
previewBackgroundColor {
alpha
blue
green
red
}
previewUrl
provenance {
certExpiresAt
certIssuedAt
certIssuer
certStatus
certSubject
contentOrigin
}
relatedAssets {
total
page
limit
hasNextPage
items {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
}
revisions {
total
page
limit
hasNextPage
items {
id
createdAt
creator { id }
}
}
size
status
tags {
source
value
}
targets {
name
id
}
thumbnailUrl
title
variants {
total
page
limit
hasNextPage
items {
filename
downloadUrl
key
}
}
width
workflowTask {
title
id
description
asset {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
assignedUsers {
__typename
name
id
}
checklistItem {
total
page
limit
hasNextPage
items { id }
}
status {
name
id
enterRules
assignedUsers { id }
checklistPresets { id }
}
}
}
}
}
}
}
```
Raw: [`AssetsRelatedAssets-Video.sdl`](../examples/AssetsRelatedAssets-Video.sdl)
### `asset › relatedAssets`
```graphql
query AssetRelatedAssets {
asset(id: "…") {
relatedAssets(limit: 25, page: 1) {
items {
... on Video {
__typename
alternativeText
attachments {
name
filename
id
createdAt
downloadUrl
extension
creator {
__typename
name
id
}
modifier {
__typename
name
id
}
}
author
availability {
from
to
}
bitrate
comments {
total
page
limit
hasNextPage
items {
id
content
createdAt
isResolved
creator { id }
currentUserPermissions { canDelete }
}
}
copyright {
notice
status
}
createdAt
creator {
__typename
name
id
}
currentUserPermissions {
canComment
canDelete
canDownload
canEdit
}
customMetadata {
__typename
property {
name
id
createdAt
defaultValue
creator { id }
dependency { propertyId }
}
... on CustomMetadataValue {
value
}
... on CustomMetadataValues {
values
}
}
description
downloadUrl
duration
expiresAt
extension
externalId
fileCreatedAt
filename
height
id
isDecorative
licenses {
title
id
addByDefault
license
requireConsensus
}
location {
brand {
name
id
}
folder {
name
id
breadcrumbs { id }
}
library {
name
id
}
workspaceProject {
name
id
}
}
modifiedAt
modifier {
__typename
name
id
}
previewBackgroundColor {
alpha
blue
green
red
}
previewUrl
provenance {
certExpiresAt
certIssuedAt
certIssuer
certStatus
certSubject
contentOrigin
}
relatedAssets {
total
page
limit
hasNextPage
items {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
}
revisions {
total
page
limit
hasNextPage
items {
id
createdAt
creator { id }
}
}
size
status
tags {
source
value
}
targets {
name
id
}
thumbnailUrl
title
variants {
total
page
limit
hasNextPage
items {
filename
downloadUrl
key
}
}
width
workflowTask {
title
id
description
asset {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
assignedUsers {
__typename
name
id
}
checklistItem {
total
page
limit
hasNextPage
items { id }
}
status {
name
id
enterRules
assignedUsers { id }
checklistPresets { id }
}
}
}
}
}
}
}
```
Raw: [`AssetRelatedAssets-Video.sdl`](../examples/AssetRelatedAssets-Video.sdl)
### `brand › search`
```graphql
query BrandSearch {
brand(id: "…") {
search(limit: 25, page: 1) {
items {
... on Video {
__typename
alternativeText
attachments {
name
filename
id
createdAt
downloadUrl
extension
creator {
__typename
name
id
}
modifier {
__typename
name
id
}
}
author
availability {
from
to
}
bitrate
comments {
total
page
limit
hasNextPage
items {
id
content
createdAt
isResolved
creator { id }
currentUserPermissions { canDelete }
}
}
copyright {
notice
status
}
createdAt
creator {
__typename
name
id
}
currentUserPermissions {
canComment
canDelete
canDownload
canEdit
}
customMetadata {
__typename
property {
name
id
createdAt
defaultValue
creator { id }
dependency { propertyId }
}
... on CustomMetadataValue {
value
}
... on CustomMetadataValues {
values
}
}
description
downloadUrl
duration
expiresAt
extension
externalId
fileCreatedAt
filename
height
id
isDecorative
licenses {
title
id
addByDefault
license
requireConsensus
}
location {
brand {
name
id
}
folder {
name
id
breadcrumbs { id }
}
library {
name
id
}
workspaceProject {
name
id
}
}
modifiedAt
modifier {
__typename
name
id
}
previewBackgroundColor {
alpha
blue
green
red
}
previewUrl
provenance {
certExpiresAt
certIssuedAt
certIssuer
certStatus
certSubject
contentOrigin
}
relatedAssets {
total
page
limit
hasNextPage
items {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
}
revisions {
total
page
limit
hasNextPage
items {
id
createdAt
creator { id }
}
}
size
status
tags {
source
value
}
targets {
name
id
}
thumbnailUrl
title
variants {
total
page
limit
hasNextPage
items {
filename
downloadUrl
key
}
}
width
workflowTask {
title
id
description
asset {
__typename
title
id
alternativeText
author
attachments { id }
availability { from }
... on Audio {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Document {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on EmbeddedContent {
previewUrl
thumbnailUrl
isDecorative
}
... on File {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Image {
previewUrl
thumbnailUrl
filename
downloadUrl
}
... on Video {
previewUrl
thumbnailUrl
filename
bitrate
}
}
assignedUsers {
__typename
name
id
}
checklistItem {
total
page
limit
hasNextPage
items { id }
}
status {
name
id
enterRules
assignedUsers { id }
checklistPresets { id }
}
}
}
}
}
}
}
```
Raw: [`BrandSearch-Video.sdl`](../examples/BrandSearch-Video.sdl)