Library Service - Public

Retrieve a specific library's list of elements

get/api/v1/public/libraries/{libraryId}/elements

Request

  • Base URL: https://cc-libraries.adobe.io
  • URL: https://cc-libraries.adobe.io/api/v1/public/libraries/{libraryId}/elements
  • Auth: none declared. Required headers: 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)

Query parameters

orderBystring

Sorting option for the response list. Reverse sort is enabled with a - character ahead of the sorting vector. (ex: -modified_date) Multi-vector sort is enabled by including multiple vectors separated by commas. (ex: name,-modified_date) Sorting is not available for public libraries.

Possible Values

  • name: Sort by the name.
  • modified_date: Sort by the last modified date.
startstring

The first result to include for a paged response, 0-based. This parameter is required if a limit is specified. Paging is not available for public libraries.

limitstring

The number of results to return for a paged response. Paging is not available for public libraries.

Possible Values

  • Min: 1.
  • Max: 100.
typestring

Limits results to those identified with the provided element mimetype.

groupstring

Limits results to those assigned to the provided group_id (can be either group_id or classifier#group_id). Parameters without a classifier will populate as $default#group_id. To specify ungrouped elements, use $none$

selectorstring

Customize which data sets to include in the response. All applications using this API will need the same sets of data, but different applications will not require different depths of details. Callers can specify a comma-separated list of selectors to either limit or expand the default response. The absence of selectors will yield the default response, while including selectors gives callers access to building-blocks to compose the response to their needs.

Possible Values

  • default: Base data, use this to build out custom response.
  • details: All available data for in-depth display.
  • collaboration: Add collaboration data to a lesser-scoped selector.
  • groups: Include group data in the response.
  • rendition_grid: Provides a set of links to library element image renditions, which can be combined to create a thumbnail for the library. The main rendition link is the first asset uploaded to the library, while the tiles contain the three most recently updated library elements' rendition links.
linkIdstring

The ID associating the request with the public library landing page URL.

Headers

authorizationstring

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.

if-none-matchstring

The etag value, returns content only if the asset's etag is EXACTLY the same.

if-matchstring

The etag value, returns content only if the asset's etag is NOT the same.

x-use-cdnboolean

Set to true if the API is called from a CDN.

x-cdn-origin'melville'

Indicate which backend service should be used for a call from a CDN. Required for calls from a CDN.

Response

OK

total_countinteger

Total results for query

Changes

No recorded changes to this operation across all 6 revisions of this API.