Parsequerade / docs
App Asset Library placements
GET/library-placements/{libraryPlacementId}

Proposed · Extended read design · Adapter not implemented

Request

Routes are relative to your connection. Use a facade API key; the service manages Apple authentication.

cURL
BASE='https://asc.example.com/v1/connections/conn_example'

curl --fail-with-body "$BASE/library-placements/library_placement_123" \
  -H "Authorization: Bearer $ASC_FACADE_KEY"

asc.example.com is a placeholder for your deployment. Examples use fictional IDs.

Path parameters

NameTypeDescription
libraryPlacementIdRequiredstringThe selected resource’s ID.

Query parameters

NameTypeDescription
fieldsOptionalstringComma-separated attribute names to return. This selects read fields and does not expand relationships. Multiple values are comma-separated.
ValuesmediaType, placementType, placementGroup, createdDate, lastModifiedDate, state, stateDetails

Response

One flat object for the selected resource.

200 · application/json
{
  "id": "app_asset_library_placement_123",
  "mediaType": "IMAGE",
  "placementType": "APP_SCREENSHOT",
  "placementGroup": "placement_group_example",
  "createdDate": "2026-10-14T12:00:00Z",
  "lastModifiedDate": "2026-10-14T12:00:00Z"
}

Illustrative response. Optional read fields may be absent or null; unknown enum values are preserved.

Response fields

NameTypeDescription
idstringApple’s resource ID. Keep this string unchanged when addressing a resource.
mediaTypestringThe media type value reported by Apple for this resource.
ValuesIMAGE, VIDEO
placementTypestringThe placement type value reported by Apple for this resource.
ValuesAPP_SCREENSHOT, IMESSAGE_APP_SCREENSHOT, APP_PREVIEW, PRODUCT_PAGE_HEADER_ASSET, APP_STORE_SEARCH_RESULTS_ASSET, SEARCH_RESULTS_ADS_ASSET, TODAY_TAB_ADS_ASSET, EVENT_CARD_ASSET, EVENT_DETAILS_PAGE_ASSET, RETENTION_MESSAGE_ASSET
placementGroupstringThe placement group value reported by Apple for this resource.
createdDatestring · date-timeWhen Apple created this resource, as an RFC 3339 timestamp.
lastModifiedDatestring · date-timeWhen this resource was last changed, as an RFC 3339 timestamp.
statestringThe current state reported by Apple for this resource.
ValuesASSET_PROCESSING, FAILED, PARENT_PREPARE_FOR_SUBMISSION, PARENT_READY_FOR_REVIEW, PARENT_WAITING_FOR_REVIEW, PARENT_IN_REVIEW, PARENT_APPROVED
stateDetailsobject[]The state details value reported by Apple for this resource.
stateDetails fields
NameTypeDescription
codeOptionalstringThe code value reported by Apple for this resource.
descriptionOptionalstringThe localized store description.

Behavior

  • A nested resource must belong to the selected parent and the configured connection. The adapter validates ownership before returning data.

Errors

HTTPTypeDescription
400invalid_queryUnsupported filter, sort, limit, or cursor.
401unauthorizedMissing or invalid facade API key.
403forbidden / upstream_forbiddenThe caller or configured Apple key cannot read this resource.
404resource_not_foundThe requested resource, parent, or exact locale is absent or outside the caller’s scope.
429rate_limitedA facade or Apple rate limit was reached. Respect Retry-After when returned.
502–504upstream errorApple authentication, response parsing, availability, or timeout failure; this is not an empty result.

Apple mapping

Upstream route and translation

The adapter calls GET /v1/appAssetLibraryPlacements/{id}. Read Apple’s original endpoint ↗

Flatten Apple’s attributes into each resource object. Expose supplied singleton linkage as IDs, with no automatic relationship traversal. Read access does not make these fields writable.

Facade parameterTypeDescription
fieldsqueryfields[appAssetLibraryPlacements]

Reviewed 2026-10-14 · OpenAPI 4.5.1