Projects

Add a brand reference to a project

Changed on

Adds a reference (link) to a brand within a project. References allow projects to include content from brands. A project can have a maximum of 200 references.

post/projects/{projectId}/references

Request

  • Base URL: https://cloudstorage.adobe.io/v1
  • URL: https://cloudstorage.adobe.io/v1/projects/{projectId}/references
  • Auth: HTTP bearer

Path parameters

projectIdstring required

The unique identifier (URN) of the project to add the reference to.

Headers

x-request-idstring
Example:1234567890

The X-Request-Id header is used to identify a request.
It can be used to correlate logs and other resources and is intended to be a non-persistent identifier.

Request body

assetIdstring required

The asset ID (URN) of the brand to reference.

referenceTypestring required

The type of the reference.

Example request

{
  "assetId": "urn:aaid:sc:US:a0620477-6ba4-3c41-9a4c-ffd7a4a60291",
  "referenceType": "brand"
}

Response

Created - The reference was successfully added to the project.

referenceIdstring

The asset ID (URN) of the referenced brand.

referenceTypestring

The type of the reference.

Example response

{
  "referenceId": "urn:aaid:sc:US:a0620477-6ba4-3c41-9a4c-ffd7a4a60291",
  "referenceType": "brand",
  "asset": {
    "assetId": "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
    "name": "My Asset",
    "createdDate": "2021-01-01T00:00:00Z",
    "modifiedDate": "2021-01-01T00:00:00Z",
    "createdBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
    "modifiedBy": "08D81E3B665BE5640A495C2C@AdobeOrg",
    "path": "/My Project/My Folder/My Asset",
    "ancestors": [
      "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a174",
      "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a175",
      "urn:aaid:sc:US:4f2fc15c-c062-4951-b37b-1f65ed62a176"
    ],
    "mediaType": "image/jpeg",
    "size": 1048576
  }
}

Changes