Library Service

Update a specific library's element

Changed on

Update a specific library's element. This API is intended solely for top-level element attribute updates. Please look to PUT /api/v1/libraries/{libraryId}/elements/{elementId}/representations for updates to element assets and representations.

put/api/v1/libraries/{libraryId}/elements/metadata

Request

  • Base URL: https://cc-libraries.adobe.io
  • URL: https://cc-libraries.adobe.io/api/v1/libraries/{libraryId}/elements/metadata
  • Auth: none declared. Required headers: authorization, x-api-key

Path parameters

libraryIdstring required

The ID of the requested library. For private libraries, the library_urn should be used. (ex: urn:aaid:sc:US:1c2327c6-ca3a-8f74-11ac-d5bca13a8fc7) For public libraries, the public library id should be used. (ex: 1UTOX1PQ9YWOTFIPUEQUV0Z2XFTFFF)

Headers

authorizationstring required

An access token issued by Adobe IMS. In the header, the access token must be preceded by Bearer .

x-api-keystring required

The API key assigned to your API client account when you signed up.

x-request-idstring

A unique request identifier that you define. Used by Adobe Support to trace the request in logs. This header is automatically generated by the server and returned in the response if you do not set it explicitly.

Request body

idstring

URN of the source library, not required if copying elements within the same library

elementIdsstring[]

Example request

{
  "elements": [
    {
      "id": "b8038ad3-c41e-4f9e-a7c3-96bb475ff8ef",
      "name": "new element",
      "description": "This is my favorite element."
    }
  ]
}

Response

No Content

Changes

  • 639ee7ea9317Revision changes
    • breaking

      removed the success response with the status

    • breaking

      removed the success response with the status

    • warning

      deleted the header request parameter x-organization-id