Get Experience Asset

Changed on

Returns a 302 redirect to a short-lived pre-signed URL for the requested asset. The 302 is the expected success response — there is no 200 body.

The client's HTTP library follows the redirect automatically. Each call issues a fresh redirect with a new token.

Prefer the url field: Asset objects in GET /experiences/:id responses include a url field that already points to this endpoint. In most cases, follow that URL directly rather than constructing this endpoint from the assetId field. Use the assetId field only as a fallback when url is absent.

Response headers on 302: Location (signed URL, valid up to 60 minutes), X-Asset-Mime-Type, Cache-Control: no-store.

For limits and usage notes, see the Experience API Technical Usage Notes.

get/experiences/{experienceId}/assets/{assetId}

Request

  • Base URL: https://genstudio.adobe.io
  • URL: https://genstudio.adobe.io/experiences/{experienceId}/assets/{assetId}
  • Auth: one of:
    • OAuth 2 (client credentials, token URL https://ims-na1.adobelogin.com/ims/token/v3)
    • API key in header x-api-key

Path parameters

experienceIdstring required
Example:urn:aaid:aem:e577c7e1-c119-4892-9b97-59a9ab1927f6

A GenStudio Experience URN.

assetIdstring required
Example:urn:aaid:aem:62d4408b-13cb-4d41-8c6f-127fb2cad067

A GenStudio asset URN.

Headers

authorizationstring required
Example:Bearer eyJhbGciOiJSUz...

Bearer token from Adobe OAuth Server-to-Server credentials.

x-api-keystring required
Example:37e7532f1c5a225acf8d2fad131cde8d

Client ID from the Adobe Developer Console project.

x-ims-org-idstring required
Example:36031A56669DEACD0A49402F@AdobeOrg

IMS Organization ID (format: {HEX}@AdobeOrg). Found in Adobe Developer Console (open your project, then Credentials → OAuth Server-to-Server → Credential Details → Organization ID).

x-request-idstring
Example:550e8400-e29b-41d4-a716-446655440000

Client-generated UUID for request tracing.

x-correlation-idstring
Example:corr-abc-123

Correlation ID to group related requests.

x-adobe-accept-experimental'1' required
Example:1

Required opt-in header for experimental API endpoints. Must be set to "1". Requests without this header will receive a 400 Bad Request response.

Changes

  • fa6506f1f842Revision changes
    • breaking

      added the new required header request parameter x-adobe-accept-experimental

  • c46cf2262c37Revision changes
    • breaking

      removed the success response with the status

    • warning

      deleted the query request parameter forceOriginal

    • info

      api operation id getExperienceAssetDelivery removed and replaced with getExperienceAsset

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      media type application/json was changed to a more specific media type application/problem+json for the response status

    • info

      added the non-success response with the status