Asset API Technical Reference

The Prismic Asset API allows you to manage your repository assets in media library. This documentation provides details about the available endpoints, authentication requirements, request parameters, response models, and error handling.

This feature is in a closed beta

This feature is only available by request. Request access via the Prismic Support Portal.

Limits

Each request to the API can contain one asset.

Requests are limited to one per second.

Headers

repository

String (required)

The repository ID (e.g. your-repo-name).

authorization

String (required)

user session token from the Authentication API.

origin

String

The origin URL for your request.

Methods

GET

Retrieve a list of assets from the media library.

Copy
asset-api.prismic.io/assets

The JSON body of the request accepts the following properties:

assetType

String

Filter assets by type (e.g., "all", "image").

limit

Number

Maximum number of assets to be returned (e.g. 100).

cursor

String

ID of the asset after which to start the query (e.g. "1682333764A").

POST

Upload a new asset to the media library.

Copy
asset-api.prismic.io/assets

The body must be multipart/form-data with the asset.


Was this article helpful?
Not really
Yes, Thanks

Can't find what you're looking for? Spot an error in the documentation? Get in touch with us on our Community Forum or using the feedback form above.