---
url: "https://earlyaccess.developers.bynder.com/apis/asset-api-beta-1/versions/d41a5f27-191a-4019-9419-fe0a53e55978"
---

OpenAPI specification document.

```json
{"components":{"schemas":{"AddAssetRelationInput":{"properties":{"relatedAssetIds":{"items":{"type":"string"},"type":"array"}},"title":"AddAssetRelationInput","type":"object"},"AdvanceRightsInput":{"properties":{"isDownloadable":{"type":"boolean"},"isPublic":{"type":"boolean"}},"title":"AdvanceRightsInput","type":"object"},"AdvancedRights":{"properties":{"isDownloadable":{"type":"boolean"},"isPublic":{"type":"boolean"}},"title":"AdvancedRights","type":"object"},"Asset":{"properties":{"activeVersion":{"$ref":"#/components/schemas/VersionReference"},"advancedRights":{"$ref":"#/components/schemas/AdvancedRights"},"assetId":{"type":"string"},"assetStatus":{"type":"string"},"copyright":{"type":"string"},"description":{"type":"string"},"embargos":{"items":{"$ref":"#/components/schemas/AssetEmbargo"},"type":"array"},"moduleCode":{"$ref":"#/components/schemas/AssetModuleCode"},"name":{"type":"string"},"origin":{"type":"string"},"portalId":{"type":"string"},"timeStampCreated":{"format":"date-time","type":"string"},"timeStampModified":{"format":"date-time","type":"string"},"timeStampPublished":{"format":"date-time","type":"string"},"userCreatedId":{"type":"string"},"userModifiedId":{"type":"string"}},"title":"Asset","type":"object"},"AssetEmbargo":{"properties":{"embargoId":{"type":"string"},"embargoType":{"$ref":"#/components/schemas/AssetEmbargoType"},"timestampEnd":{"format":"date-time","type":"string"},"timestampStart":{"format":"date-time","type":"string"}},"title":"AssetEmbargo","type":"object"},"AssetEmbargoType":{"enum":["archive","limited","watermark"],"title":"AssetEmbargoType","type":"string"},"AssetModuleCode":{"enum":["BG","BS","IB","WF"],"title":"AssetModuleCode","type":"string"},"AssetRelation":{"properties":{"relatedAssetIds":{"items":{"type":"string"},"type":"array"},"relationId":{"type":"string"}},"title":"AssetRelation","type":"object"},"AssetRequestFailureError":{"properties":{"message":{"type":"string"}},"title":"AssetRequestFailureError","type":"object"},"AssetTaxonomy":{"properties":{"assetId":{"type":"string"},"id":{"type":"string"},"metaPropertyOptionGroups":{"items":{"$ref":"#/components/schemas/MetaPropertyOptionGroup"},"type":"array"},"metaPropertyValues":{"items":{"$ref":"#/components/schemas/MetaPropertyValue"},"type":"array"},"metadata":{"items":{"$ref":"#/components/schemas/AssetTaxonomyMetaDataValue"},"type":"array"},"portalId":{"type":"string"},"taxonomyStatus":{"type":"string"},"timeStampModified":{"format":"date-time","type":"string"},"versionId":{"type":"string"}},"title":"AssetTaxonomy","type":"object"},"AssetTaxonomyMetaDataValue":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"title":"AssetTaxonomyMetaDataValue","type":"object"},"AssetValidationError":{"properties":{"code":{"type":"string"},"description":{"type":"string"}},"title":"AssetValidationError","type":"object"},"AssetVersion":{"properties":{"assetId":{"type":"string"},"assetVersionStatus":{"type":"string"},"derivatives":{"items":{"$ref":"#/components/schemas/AssetVersionDerivative"},"type":"array"},"fileObject":{"$ref":"#/components/schemas/FileObject"},"id":{"type":"string"},"portalId":{"type":"string"},"timeStampCreated":{"format":"date-time","type":"string"},"timeStampModified":{"format":"date-time","type":"string"},"userCreatedId":{"type":"string"},"userModifiedId":{"type":"string"}},"title":"AssetVersion","type":"object"},"AssetVersionDerivative":{"properties":{"derivativeReferenceId":{"type":"string"},"derivativeType":{"$ref":"#/components/schemas/DerivativeType"},"file":{"$ref":"#/components/schemas/DerivativeFileObject"},"id":{"type":"string"},"isPublic":{"type":"boolean"},"name":{"type":"string"}},"title":"AssetVersionDerivative","type":"object"},"BG":{"title":"BG","type":"object"},"BS":{"title":"BS","type":"object"},"BadGatewayError":{"properties":{"message":{"type":"string"}},"title":"BadGatewayError","type":"object"},"BadRequestError":{"properties":{"message":{"type":"string"}},"title":"BadRequestError","type":"object"},"CreateAssetEmbargoInput":{"properties":{"embargoTimeStamp":{"format":"date-time","type":"string"},"embargoType":{"$ref":"#/components/schemas/AssetEmbargoType"}},"required":["embargoType"],"title":"CreateAssetEmbargoInput","type":"object"},"CreateAssetEmbargoReply":{"properties":{"assetId":{"type":"string"},"embargo":{"$ref":"#/components/schemas/AssetEmbargo"}},"title":"CreateAssetEmbargoReply","type":"object"},"CreateAssetInput":{"properties":{"copyright":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"},"origin":{"type":"string"},"timeStampPublished":{"format":"date-time","type":"string"}},"title":"CreateAssetInput","type":"object"},"CreateCropError":{"properties":{"message":{"type":"string"}},"title":"CreateCropError","type":"object"},"CreateError":{"properties":{"message":{"type":"string"}},"title":"CreateError","type":"object"},"DeleteEmbargoReply":{"properties":{"assetId":{"type":"string"}},"title":"DeleteEmbargoReply","type":"object"},"DerivativeFileObject":{"properties":{"fileName":{"type":"string"},"fileSize":{"format":"int64","type":"integer"},"fileType":{"type":"string"},"id":{"type":"string"}},"title":"DerivativeFileObject","type":"object"},"DerivativeType":{"enum":["additional","intermediate","manual","thumbnail","web"],"title":"DerivativeType","type":"string"},"DomainError":{"oneOf":[{"$ref":"#/components/schemas/AssetRequestFailureError"},{"$ref":"#/components/schemas/BadGatewayError"},{"$ref":"#/components/schemas/BadRequestError"},{"$ref":"#/components/schemas/CreateCropError"},{"$ref":"#/components/schemas/CreateError"},{"$ref":"#/components/schemas/EditAdvanceRightsError"},{"$ref":"#/components/schemas/EditError"},{"$ref":"#/components/schemas/ForbiddenError"},{"$ref":"#/components/schemas/GatewayTimeoutError"},{"$ref":"#/components/schemas/GetAssetRelationsError"},{"$ref":"#/components/schemas/HealthError"},{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/NotFoundError"},{"$ref":"#/components/schemas/NotImplementedError"},{"$ref":"#/components/schemas/PublishAssetError"},{"$ref":"#/components/schemas/ReTriggerError"},{"$ref":"#/components/schemas/RestoreError"},{"$ref":"#/components/schemas/RetrieveError"},{"$ref":"#/components/schemas/ReviewAssetVersionError"},{"$ref":"#/components/schemas/SetAutoTagsError"},{"$ref":"#/components/schemas/SetVersionTagsError"},{"$ref":"#/components/schemas/TrashError"},{"$ref":"#/components/schemas/UnauthorizedError"},{"$ref":"#/components/schemas/UpdateAssetRelationError"},{"$ref":"#/components/schemas/UpdateTaxonomyError"},{"$ref":"#/components/schemas/UploadUrlError"},{"$ref":"#/components/schemas/ValidateAssetError"}],"title":"DomainError"},"EditAdvanceRightsError":{"properties":{"message":{"type":"string"}},"title":"EditAdvanceRightsError","type":"object"},"EditAssetInput":{"properties":{"copyright":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"},"timeStampPublished":{"type":"string"}},"title":"EditAssetInput","type":"object"},"EditError":{"properties":{"message":{"type":"string"}},"title":"EditError","type":"object"},"FileObject":{"properties":{"fileName":{"type":"string"},"fileSize":{"format":"int64","type":"integer"},"fileType":{"type":"string"},"id":{"type":"string"},"md5":{"type":"string"},"metadata":{"properties":{"key":{"type":"string"},"value":{"type":"string"}},"type":"object"}},"title":"FileObject","type":"object"},"ForbiddenError":{"properties":{"message":{"type":"string"}},"title":"ForbiddenError","type":"object"},"GatewayTimeoutError":{"properties":{"message":{"type":"string"}},"title":"GatewayTimeoutError","type":"object"},"GetAssetRelationsError":{"properties":{"message":{"type":"string"}},"title":"GetAssetRelationsError","type":"object"},"GetAssetRelationsReply":{"properties":{"assetId":{"type":"string"},"portalId":{"type":"string"},"relations":{"items":{"$ref":"#/components/schemas/AssetRelation"},"type":"array"}},"title":"GetAssetRelationsReply","type":"object"},"GetVersionThumbnailsReply":{"properties":{"assetId":{"type":"string"},"thumbnails":{"items":{"$ref":"#/components/schemas/ThumbnailReply"},"type":"array"},"versionId":{"type":"string"}},"title":"GetVersionThumbnailsReply","type":"object"},"HealthError":{"properties":{"message":{"type":"string"}},"title":"HealthError","type":"object"},"IB":{"title":"IB","type":"object"},"InternalError":{"properties":{"message":{"type":"string"}},"title":"InternalError","type":"object"},"MetaPropertyOptionGroup":{"properties":{"isRemoved":{"type":"boolean"},"metaPropertyId":{"type":"string"},"metaPropertyType":{"$ref":"#/components/schemas/MetaPropertyType"},"values":{"items":{"$ref":"#/components/schemas/ValueReference"},"type":"array"}},"title":"MetaPropertyOptionGroup","type":"object"},"MetaPropertyType":{"enum":["option","tag","autotag"],"title":"MetaPropertyType","type":"string"},"MetaPropertyValue":{"properties":{"isRemoved":{"type":"boolean"},"metaPropertyId":{"type":"string"},"metaPropertyType":{"$ref":"#/components/schemas/MetaPropertyValueType"},"value":{"type":"string"}},"title":"MetaPropertyValue","type":"object"},"MetaPropertyValueType":{"enum":["text","date"],"title":"MetaPropertyValueType","type":"string"},"MetapropertyOptionGroupInput":{"properties":{"metaPropertyType":{"enum":["option"],"type":"string"},"values":{"items":{"type":"string"},"type":"array"}},"required":["metaPropertyType"],"title":"MetapropertyOptionGroupInput","type":"object"},"MetapropertyValueInput":{"properties":{"metaPropertyType":{"$ref":"#/components/schemas/MetaPropertyValueType"},"value":{"type":"string"}},"required":["metaPropertyType","value"],"title":"MetapropertyValueInput","type":"object"},"NotFoundError":{"properties":{"message":{"type":"string"}},"title":"NotFoundError","type":"object"},"NotImplementedError":{"properties":{"message":{"type":"string"}},"title":"NotImplementedError","type":"object"},"OriginInput":{"properties":{"origin":{"type":"string"}},"title":"OriginInput","type":"object"},"PublishAssetError":{"properties":{"message":{"type":"string"}},"title":"PublishAssetError","type":"object"},"PublishAssetInput":{"properties":{"forcePublish":{"default":false,"description":"When true, forces publication of the asset even if non-blocking validation warnings are present. Defaults to false.","type":"boolean"}},"title":"PublishAssetInput","type":"object"},"ReTriggerError":{"properties":{"message":{"type":"string"}},"title":"ReTriggerError","type":"object"},"ReTriggerReply":{"properties":{"assetId":{"type":"string"},"success":{"type":"boolean"},"versionId":{"type":"string"}},"required":["assetId","versionId","success"],"title":"ReTriggerReply","type":"object"},"RemoveAssetRelationInput":{"properties":{"relatedAssetIds":{"items":{"type":"string"},"type":"array"}},"title":"RemoveAssetRelationInput","type":"object"},"RestoreAssetReply":{"properties":{"assetId":{"type":"string"}},"required":["assetId"],"title":"RestoreAssetReply","type":"object"},"RestoreError":{"properties":{"message":{"type":"string"}},"title":"RestoreError","type":"object"},"RetrieveError":{"properties":{"message":{"type":"string"}},"title":"RetrieveError","type":"object"},"ReviewAssetVersionError":{"properties":{"message":{"type":"string"}},"title":"ReviewAssetVersionError","type":"object"},"ServiceHealth":{"properties":{"hostname":{"type":"string"},"message":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["message","hostname","timestamp"],"title":"ServiceHealth","type":"object"},"SetAssetVersionAutoTagsInput":{"properties":{"autoTags":{"items":{"type":"string"},"type":"array"}},"title":"SetAssetVersionAutoTagsInput","type":"object"},"SetAssetVersionAutoTagsReply":{"properties":{"autoTags":{"items":{"type":"string"},"type":"array"}},"title":"SetAssetVersionAutoTagsReply","type":"object"},"SetAutoTagsError":{"properties":{"message":{"type":"string"}},"title":"SetAutoTagsError","type":"object"},"SetTagsInput":{"properties":{"tags":{"items":{"type":"string"},"type":"array"}},"title":"SetTagsInput","type":"object"},"SetVersionTagsError":{"properties":{"message":{"type":"string"}},"title":"SetVersionTagsError","type":"object"},"SetVersionTagsReply":{"properties":{"assetId":{"type":"string"},"versionId":{"type":"string"}},"title":"SetVersionTagsReply","type":"object"},"ThumbnailReply":{"properties":{"name":{"type":"string"},"thumbnailUrl":{"type":"string"}},"title":"ThumbnailReply","type":"object"},"TrashAssetReply":{"properties":{"assetId":{"type":"string"}},"title":"TrashAssetReply","type":"object"},"TrashError":{"properties":{"message":{"type":"string"}},"title":"TrashError","type":"object"},"UnauthorizedError":{"properties":{"message":{"type":"string"}},"title":"UnauthorizedError","type":"object"},"UpdateAssetEmbargoInput":{"properties":{"embargoTimeStamp":{"format":"date-time","type":"string"}},"title":"UpdateAssetEmbargoInput","type":"object"},"UpdateAssetEmbargoReply":{"properties":{"assetId":{"type":"string"},"embargo":{"$ref":"#/components/schemas/AssetEmbargo"}},"title":"UpdateAssetEmbargoReply","type":"object"},"UpdateAssetMetapropertyInput":{"properties":{"metaPropertyOptionGroup":{"$ref":"#/components/schemas/MetapropertyOptionGroupInput"},"metaPropertyValue":{"$ref":"#/components/schemas/MetapropertyValueInput"}},"title":"UpdateAssetMetapropertyInput","type":"object"},"UpdateAssetRelationError":{"properties":{"message":{"type":"string"}},"title":"UpdateAssetRelationError","type":"object"},"UpdateAssetRelationInput":{"properties":{"relatedAssetIds":{"items":{"type":"string"},"type":"array"}},"title":"UpdateAssetRelationInput","type":"object"},"UpdateAssetRelationReply":{"properties":{"assetId":{"type":"string"},"portalId":{"type":"string"},"relatedAssetIds":{"items":{"type":"string"},"type":"array"},"relationId":{"type":"string"}},"title":"UpdateAssetRelationReply","type":"object"},"UpdateMetaPropertyOptionGroup":{"properties":{"metaPropertyId":{"type":"string"},"metaPropertyType":{"enum":["option"],"type":"string"},"values":{"items":{"type":"string"},"type":"array"}},"required":["metaPropertyId","metaPropertyType"],"title":"UpdateMetaPropertyOptionGroup","type":"object"},"UpdateMetaPropertyValue":{"properties":{"metaPropertyId":{"type":"string"},"metaPropertyType":{"$ref":"#/components/schemas/MetaPropertyValueType"},"value":{"type":"string"}},"required":["metaPropertyId","metaPropertyType","value"],"title":"UpdateMetaPropertyValue","type":"object"},"UpdateTaxonomy":{"properties":{"metaPropertyOptionGroups":{"items":{"$ref":"#/components/schemas/UpdateMetaPropertyOptionGroup"},"type":"array"},"metaPropertyValues":{"items":{"$ref":"#/components/schemas/UpdateMetaPropertyValue"},"type":"array"}},"title":"UpdateTaxonomy","type":"object"},"UpdateTaxonomyError":{"properties":{"message":{"type":"string"}},"title":"UpdateTaxonomyError","type":"object"},"UploadUrl":{"properties":{"storageObjectId":{"type":"string"},"uploadUrl":{"type":"string"}},"title":"UploadUrl","type":"object"},"UploadUrlError":{"properties":{"message":{"type":"string"}},"title":"UploadUrlError","type":"object"},"ValidateAssetError":{"properties":{"message":{"type":"string"}},"title":"ValidateAssetError","type":"object"},"ValidateAssetReply":{"properties":{"assetId":{"type":"string"},"validationErrors":{"items":{"$ref":"#/components/schemas/AssetValidationError"},"type":"array"},"versionId":{"type":"string"}},"title":"ValidateAssetReply","type":"object"},"ValueReference":{"properties":{"id":{"type":"string"},"isRemoved":{"type":"boolean"}},"title":"ValueReference","type":"object"},"VersionReference":{"properties":{"timeStampCreated":{"format":"date-time","type":"string"},"versionId":{"type":"string"}},"title":"VersionReference","type":"object"},"WF":{"title":"WF","type":"object"},"archive":{"title":"archive","type":"object"},"limited":{"title":"limited","type":"object"},"watermark":{"title":"watermark","type":"object"}},"securitySchemes":{"httpAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"**Beta.** The Asset API lets you ingest, enrich, and manage assets on `api.bynder.com`. Endpoints are grouped by the stage of the asset lifecycle: ingestion (create → upload → publish), enrichment (metadata, tags, embargoes, rights, relations), and general retrieval/management.","title":"Asset API (Beta)","version":"1.0.0-beta"},"openapi":"3.1.0","paths":{"/":{"patch":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n The request target is the `Location` response header returned by **Upload file initialization**. Carry the relevant header information across calls as shown below. After the last chunk is uploaded, the file is automatically finalized. \n> The `Location Header Value` URL is a placeholder for the `Location` header from the previous call.","operationId":"patchUploadFileChunks","parameters":[{"in":"header","name":"tus-resumable","required":true,"schema":{"default":"1.0.0","type":"string"}},{"description":"The combined length of the previously uploaded chunks. This value can be taken from the Upload-Offset response header of each preceding chunk request.","in":"header","name":"upload-offset","required":true,"schema":{"type":"string"}},{"in":"header","name":"content-type","required":true,"schema":{"default":"application/offset+octet-stream","type":"string"}},{"in":"header","name":"fileid","required":true,"schema":{"type":"string"}},{"in":"header","name":"filename","required":true,"schema":{"type":"string"}},{"in":"header","name":"reason","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/offset+octet-stream":{"schema":{"format":"binary","type":"string"}}},"required":true},"responses":{"200":{"description":"Chunk accepted.","headers":{"Upload-Offset":{"description":"New offset after this chunk; use it for the next chunk request.","schema":{"type":"integer"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""}},"security":[{"httpAuth":[]}],"servers":[{"description":"Dynamic Tus upload server returned in the previous step.","url":"{Location Header Value}","variables":{"baseUploadUrl":{"default":"{Location Header Value}"}}}],"summary":"Upload file chunks","tags":["Asset ingestion"]},"post":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n This step actually starts uploading the file. Send this request to the signed `uploadUrl` returned by **Create upload url**. This initializes a resumable (tus) upload. Any file namings have to be base64 encoded/decoded. \nThe response headers - in particular the `Location` header - are required for the next call, **Upload file chunks**. \n> The `{uploadUrl}` path parameter is a placeholder for the signed URL from the previous step.","operationId":"postUploadUrlInitialization","parameters":[{"in":"header","name":"tus-resumable","required":true,"schema":{"default":"1.0.0","type":"string"}},{"description":"Total size of the file to upload, in bytes.","in":"header","name":"upload-length","required":true,"schema":{"type":"string"}},{"description":"Comma-separated `key <base64-value>` pairs, e.g. `filename ZXhhbXBsZS5wbmc=`.","in":"header","name":"upload-metadata","required":true,"schema":{"contentEncoding":"base64","type":"string"}},{"in":"header","name":"fileid","required":true,"schema":{"type":"string"}},{"in":"header","name":"filename","required":true,"schema":{"type":"string"}},{"in":"header","name":"authorization","required":true,"schema":{"type":"string"}},{"in":"header","name":"content-length","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Upload initialized. Use the returned Location header for the chunk uploads.","headers":{"Content-Length":{"schema":{"type":"integer"}},"Tus-Resumable":{"schema":{"type":"string"}},"Upload-Chunk-Size":{"schema":{"type":"integer"}},"X-Content-Type-Options":{"schema":{"type":"string"}},"location":{"description":"URL to send the file chunks to (used by Upload file chunks).","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""}},"security":[{"httpAuth":[]}],"servers":[{"description":"Dynamic Tus upload server returned in the previous step.","url":"{uploadUrl}","variables":{"baseUploadUrl":{"default":"{your-dynamic-upload-url}"}}}],"summary":"Upload file initialization","tags":["Asset ingestion"]}},"/api/1/asset/assets":{"post":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Creates an empty container, this is the first step to start the file upload and any asset enrichment.","operationId":"postApi1AssetAssets","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Create asset","tags":["Asset ingestion"]}},"/api/1/asset/assets/{assetId}":{"delete":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Delete an asset that is currently in draft. Due to the draft state, you cannot restore the asset from the trashcan.","operationId":"deleteApi1AssetAssetsAssetid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrashAssetReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Delete asset","tags":["General endpoints"]},"get":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Retrieves the asset and all its details. This endpoint is currently only available for the creator of the asset to view the asset. \n\nDuring any point of the upload process, the asset can be retrieved to see the active status and the state of the asset.","operationId":"getApi1AssetAssetsAssetid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Get asset","tags":["General endpoints"]},"patch":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Edit the core properties of an asset. Each property can individually be updated, without needing to send the rest.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"patchApi1AssetAssetsAssetid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditAssetInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Edit asset","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/advanced-rights":{"patch":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Update the value of the asset advanced rights (downloadable, or isPublic). These properties have to be carefully considered when changing, with their potential security implications. Either property can be updated individually.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"patchApi1AssetAssetsAssetidAdvanced-rights","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvanceRightsInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Update advanced right","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/autotags":{"put":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Adjust the autotag values that are set on an asset. The input list can only set values that are already present on the asset to reduce the list of autotags, not to add additional ones.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"putApi1AssetAssetsAssetidAutotags","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAssetVersionAutoTagsInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAssetVersionAutoTagsReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Set autotags","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/embargos":{"post":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Create a new current or future embargo on the asset. There are 3 types of embargo available, 'archive', 'watermark', 'limited'. Of which only 1 can be active at the same time.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"postApi1AssetAssetsAssetidEmbargos","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetEmbargoInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetEmbargoReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Create embargo","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/embargos/{embargoId}":{"delete":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Completely delete an existing asset embargo.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"deleteApi1AssetAssetsAssetidEmbargosEmbargoid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"embargoId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteEmbargoReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Delete embargo","tags":["Asset enrichment"]},"put":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n For an existing asset embargo, update the date restrictions of that embargo.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"putApi1AssetAssetsAssetidEmbargosEmbargoid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"embargoId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetEmbargoInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetEmbargoReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Update embargo","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/metaproperties":{"get":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Retrieve all metaproperty values set on the active asset version. The responses are taxonomy references, not direct labels.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"getApi1AssetAssetsAssetidMetaproperties","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTaxonomy"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Get asset metaproperties","tags":["Asset enrichment"]},"put":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Update the metaproperty option values of an asset, the given input will overwrite everything metaproperty wise that is on the asset. This does not include tags and autotags.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"putApi1AssetAssetsAssetidMetaproperties","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTaxonomy"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTaxonomy"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Set asset metaproperties","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/metaproperties/{metapropertyId}":{"delete":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Delete a metaproperties options or value from an asset.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"deleteApi1AssetAssetsAssetidMetapropertiesMetapropertyid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"metapropertyId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTaxonomy"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Delete individual asset metaproperty","tags":["Asset enrichment"]},"put":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Update the metaproperty values of a specific metaproperty on an asset. The full list of options or value for the given metaproperty is overwritten. This endpoint can also be used if no values for the given metaproperty are set on the asset yet.\n\n> **Note:** doing the update request with an empty list of values will delete the metaproperty and its values from the asset.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"putApi1AssetAssetsAssetidMetapropertiesMetapropertyid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"metapropertyId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetMetapropertyInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetTaxonomy"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Update individual asset metaproperty","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/publish":{"post":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Once the file is fully enriched and ready it can be published. Depending on the profile permissions of the user, the asset will go directly to the asset bank (upload assets) or to the waiting room (upload assets with mandatory approval)","operationId":"postApi1AssetAssetsAssetidPublish","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishAssetInput"}}},"description":"Optional publish options. If omitted, the asset is published with default settings (forcePublish = false).","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Asset"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Publish","tags":["Asset ingestion"]}},"/api/1/asset/assets/{assetId}/relations":{"get":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Retrieves all relations defined on an asset, the response will include all relations per relationId.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"getApi1AssetAssetsAssetidRelations","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAssetRelationsReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Get asset relations","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/relations/{relationId}":{"post":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Add one or more assets to the set of assets the given asset is related to. The result is a bidirectional relation between the given asset and the assets given as input Note: the recommended maximum amount of Ids to relate is 100 maximum.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"postApi1AssetAssetsAssetidRelationsRelationid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"relationId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddAssetRelationInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetRelationReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Add asset relations","tags":["Asset enrichment"]},"delete":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Remove one or more assets from the set of assets the given asset is related to. This removes the bidirectional relation between the given asset and the assets given as input.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"deleteApi1AssetAssetsAssetidRelationsRelationid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"relationId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemoveAssetRelationInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetRelationReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Remove asset relations","tags":["Asset enrichment"]},"put":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Update the set of assets the given asset is related to. The result is a bidirectional relation between the given asset and the asset's given as input Note: the recommended maximum amount of Ids to relate is 100 maximum.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"putApi1AssetAssetsAssetidRelationsRelationid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"relationId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetRelationInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetRelationReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Set asset relations","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/tags":{"put":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Set a given list of tags as the new tag list of an asset.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","operationId":"putApi1AssetAssetsAssetidTags","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetTagsInput"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetVersionTagsReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Set tags","tags":["Asset enrichment"]}},"/api/1/asset/assets/{assetId}/thumbnails":{"get":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Retrieve the thumbnails of the active version of an asset. The response includes the signed url for directly using the thumbnails.","operationId":"getApi1AssetAssetsAssetidThumbnails","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetVersionThumbnailsReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Get the active asset version thumbnails","tags":["General endpoints"]}},"/api/1/asset/assets/{assetId}/upload-url":{"post":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n To start uploading a file as an asset, a signed upload url has to be created, which can be used to start uploading the file. Take the generated assetId from the previous {create Asset} as input in the path.","operationId":"postApi1AssetAssetsAssetidUpload-url","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadUrl"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Create upload url","tags":["Asset ingestion"]}},"/api/1/asset/assets/{assetId}/validate":{"get":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Validate if the asset in its current state is good to be published.","operationId":"getApi1AssetAssetsAssetidValidate","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateAssetReply"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Validate asset","tags":["General endpoints"]}},"/api/1/asset/assets/{assetId}/versions/{versionId}":{"get":{"description":"> **IMPORTANT NOTE**\n> These APIs do not replace the existing v4 APIs yet, and currently only applies to newly uploaded assets still in Draft state (before publishing). Cannot be yet used for Assets that are in Asset Bank and Waiting room. \n\n Get all details about a given asset version. This does not have to be the active version of the asset. This endpoint is currently only available for the creator of the asset to view the asset.","operationId":"getApi1AssetAssetsAssetidVersionsVersionid","parameters":[{"in":"path","name":"assetId","required":true,"schema":{"type":"string"}},{"in":"path","name":"versionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetVersion"}}},"description":""},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestError"}}},"description":""},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedError"}}},"description":""},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/InternalError"},{"$ref":"#/components/schemas/DomainError"}]}}},"description":""},"501":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotImplementedError"}}},"description":""},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayError"}}},"description":""},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutError"}}},"description":""}},"security":[{"httpAuth":[]}],"summary":"Get version","tags":["General endpoints"]}}},"servers":[{"url":"https://{your-bynder-domain}/"}],"tags":[{"description":"Create an asset, upload its file in resumable chunks, and publish it. After the file is uploaded you can **enrich the asset** - see the *Asset enrichment* section - before publishing. Retrieval of the asset during ingestion uses **Get asset** in the *General endpoints* section.","name":"Asset ingestion"},{"description":"Add or update metadata, metaproperties, tags, autotags, embargoes, advanced rights, and relations on an asset before (or after) publishing.\n\n> **Note:** This API is subject to change until it reaches GA. Activation of the API is on a request basis until GA.","name":"Asset enrichment"},{"description":"Retrieve, validate, and manage existing assets and their versions.","name":"General endpoints"}]}
```