Fetching assets

Prepr stores all your digital assets in the Media Library (in Prepr: the Media tab), making it easy to access, view, and manage your assets. You can add, edit, download, or delete files whenever needed; categorize, search, and filter assets on multiple attributes to find the right one quickly.

The Asset object

    "id": "df7c1544-bad0-4c9d-928f-0c9f684c9ceb",
    "created_on": "2023-06-13T14:35:54+00:00",
    "changed_on": "2023-06-13T14:35:54+00:00",
    "label": "Photo",
    "name": "Sed et augue non mi dapibus tincidunt sollicitudin vel leo",
    "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Duis vel ornare massa. Ut vehicula commodo consequat.",
    "author": "Marc van Dam",
    "status": null,
    "reference_id": "dam-249387",
    "width": 1020,
    "height": 1020,
    "original_name": "sed-et-augue.jpg",
    "mime_type": "image/jpeg",
    "cdn_files": {
        "total": 1,
        "items": [
                "id": "bfaac48b-fb0d-4d12-84da-af8d65244c4b",
                "created_on": "2023-06-12T08:44:43+00:00",
                "label": "CdnFile",
                "file": "371apne44zy3.jpg",
                "url": "https://example.stream.prepr.io/{format}/371apne44zy3-5az.jpg"
idUnique identifier for each item.
created_onUTC time at which the asset was created/upload.
changed_onUTC time at which the asset was last updated.
labelIdentifier for the object.
nameName of the asset.
bodyDescription of the asset.
reference_idCustom asset API ID.
authorOptional name of the author.
widthWidth of the image of video.
heightHeight of the image of video.
original_nameName of the uploaded file.
mime_typeMime type of the original file.
cdn_filesArray, the url field can be used for media playback.

Fetching all assets

GET: /assets

The pagination of the asset endpoint is identical to the content items endpoints.

Query by ID

Since IDs are unique in Prepr, you can find the asset you want using the id argument. Here is an example that demonstrates how to query an asset with the ID "535c1e-...":

GET: /assets/535c1e-4d52-4794-9136-71e28f2ce4c1