v1

latestOpenAPI 3.0.02026-07-2417611.8 MB

Authoring assets

AI analyzes the asset. The analysis results are stored on the asset itself.

Use the /assets/{id}/analyze endpoint to perform AI analysis on asset if supported. <br />User roles: admin, manager, editor

post/authoring/v1/assets/{id}/analyze

Path parameters

idstring required

Provide the ID of the asset item that you need to perform AI analytics.

Query parameters

autocurateboolean

Set the autocurate parameter to true automatically curate and accept all suggested tags.

Response

The asset after getting updated with AI analysis results.

idstring

The id of the asset.

revstring

The revision of the asset.

namestring

Name of the asset.

classification'asset'

The classification of the asset is always "asset".

assetType'image' | 'video' | 'file'

The type of asset. Determined by the media type of the resource.

descriptionstring

Description of the asset.

creatorIdstring

The ID of the user that created the asset.

createdstring date-time

The date and time the asset was created.

creatorstring

The name of the user who originally created the asset.

lastModifierIdstring

The ID of the user that last modified the asset.

lastModifiedstring date-time

The date and time the asset was last modified.

lastModifierstring

The name of the user who last modified the item.

systemModifiedstring date-time

The date and time the asset was last modified by the system.

fileNamestring

The file name of the asset's resource.

fileSizeinteger

The size of the asset's resource in bytes.

mediaTypestring

Media type of the asset's resource.

keywordsstring[]

When AI analysis is complete, the document type assets will be automatically updated with keywords generated by the analysis. Keywords are updated only for PDF, doc, html, and plain text files.

resourcestring required

The ID of the uploaded resource this asset contains.

digeststring

The Base64 encoded MD5 digest of the resouce the asset contains.

pathstring

The path to this asset, must begin with a leading slash. A unique constraint is placed on this path so that no other asset can have the same path. When updating path a collision results in error. Paths begining with "/dxdam/" are managed assets.

categoryIdsstring[]

The IDs of the categories that define how this asset is categorized.

profilesstring[]

The IDs of image profiles to add to use on this asset.

status'ready' | 'draft' | 'retired'

The workflow status of the asset.

validboolean

Boolean that indicates if an asset can be transitioned from draft to ready. Only available on draft assets.

draftStatus'in-review' | 'in-progress' | 'approved'

This property shows the status of the draft and is only valid for draft items. By default, it is in-progress.

isManagedboolean

This field indicates whether the asset is managed or not. An asset is considered managed only if its asset path starts with "dxdam".

altTextstring

A text description of the asset, used when the asset itself is not available or not displayed.

captionstring

A caption of the asset image.

linkedDocIdstring

Provided on drafts of existing items. This is the ID of the primary item.

categoriesstring[]

isSystemboolean

Indicates whether this item is a 'system item' or not. 'System item' means that this is an item managed internally by Acoustic.

libraryIdstring

If this property is set it points to library id that the item is assigned to.

Example response

{
  "id": "0a800487f06d71eaf4cffdfde1ab28bc",
  "rev": "2-c839bbb8844549c2e298275c4b2adcb8",
  "description": "This is an image of a person.",
  "creatorId": "e98c185a-cafb-4c32-ad94-dd4ffaa28a7e",
  "lastModifierId": "e98c185a-cafb-4c32-ad94-dd4ffaa28a7e",
  "fileName": "hub.png",
  "fileSize": 123125,
  "mediaType": "image/png",
  "tags": {
    "values": [
      "faces:Lebron James",
      "sports",
      "basketball"
    ]
  },
  "resource": "67c621ed48921b7338b84b4f415cba6b",
  "digest": "9jwWuI3TN+PhGfHcrSJHcQ==",
  "path": "/sales/images/hub.png",
  "categoryIds": [],
  "profiles": [
    "8b4698e3-6283-4bc5-9e1e-fff69c2b48be"
  ],
  "profileRenditions": [
    {
      "profileId": "a35f02ce-9f31-4832-8ed5-2b6d9c8b8d86",
      "profileName": "Profile E",
      "key": "renditionF",
      "label": "Rendition F",
      "transform": {
        "scale": 0.0862,
        "crop": {
          "x": 0,
          "y": 0,
          "width": 10,
          "height": 10
        }
      },
      "uri": "/authoring/v1/resources/e17b2c51-a74e-4332-80df-0f6d9340426c?resize=10px:10px&crop=10:10;0,0",
      "width": 10,
      "height": 10
    },
    {
      "profileId": "a35f02ce-9f31-4832-8ed5-2b6d9c8b8d86",
      "profileName": "Profile E",
      "key": "renditionG",
      "label": "Rendition G",
      "transform": {
        "scale": 0.17241,
        "crop": {
          "x": 0,
          "y": 0,
          "width": 20,
          "height": 20
        }
      },
      "uri": "/authoring/v1/resources/e17b2c51-a74e-4332-80df-0f6d9340426c?resize=20px:20px&crop=20:20;0,0",
      "width": 20,
      "height": 20
    }
  ],
  "links": {
    "self": {
      "href": "/authoring/v1/assets/1e5fecbb-04aa-4ed2-a014-8e544ad97597:draft"
    },
    "media": {
      "href": "/authoring/v1/resource/myResource.jpeg"
    },
    "thumbnail": {
      "href": "/authoring/v1/resource/myResource.jpeg?fit=around|220:145&crop=220:145;*,*"
    },
    "ready": {
      "href": "/authoring/v1/changes/asset/1e5fecbb-04aa-4ed2-a014-8e544ad97597:draft/status/ready"
    },
    "retire": {
      "href": "/authoring/v1/changes/asset/1e5fecbb-04aa-4ed2-a014-8e544ad97597:draft/status/retire"
    },
    "linkedDoc": {
      "href": "/authoring/v1/assets/1e5fecbb-04aa-4ed2-a014-8e544ad97597"
    }
  },
  "usageRights": {
    "categories": [
      {
        "id": "00000000-0000-0000-0000-021000c8e20",
        "path": "Usage rights/Rights managed/Usage realm/Advertising"
      }
    ],
    "expiration": "2017-08-28T14:00:00Z"
  },
  "review": {
    "id": "3356c048-96d0-4d8d-9afe-5e7ae47b127a",
    "name": "my review",
    "started": "2017-07-10T03:20:10Z",
    "ends": "2017-07-10T03:20:10Z",
    "ended": "2017-07-12T19:40:10Z"
  },
  "metadata": {
    "width": 1000,
    "height": 1000,
    "camera": {
      "make": "NIKON CORPORATION",
      "model": "NIKON D90",
      "focalLength": 35,
      "shutterSpeed": "1/200",
      "iso": 100,
      "aperture": 8
    },
    "coverage": "1972-",
    "creator": "Acoustic",
    "Date": "2017-10-23T01:23:57Z",
    "description": "The Acoustic logo.",
    "publisher": "Acoustic",
    "rights": "Acoustic",
    "source": "Acoustic",
    "title": "Acoustic Logo",
    "headline": "The Acoustic logo."
  },
  "cognitive": {
    "faces": [
      {
        "name": "Brad Pitt",
        "gender": "Male",
        "age": {
          "minimum": 35,
          "maximum": 44
        }
      }
    ],
    "colors": {
      "vibrant": "#c78061",
      "muted": "#ae7157",
      "darkVibrant": "#4c2c1c",
      "darkMuted": "#50453f",
      "lightVibrant": "#d4a185",
      "lightMuted": "#d4bcac"
    },
    "entities": "people"
  },
  "altText": "This is an image of the Acoustic logo.",
  "caption": "Acoustic",
  "linkedDocId": "b289c02e-2c61-4643-aba6-e6b4e94c76e3",
  "categories": [
    "banner"
  ]
}