Get asset by UUID

Production

https://api-v2.getmarvia.com

GET

/v1/assets/{uuid}

Required Permission: read:assets

This endpoint requires an API key with the read:assets permission. Make sure your token was created with this permission during token creation.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Header Params

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api-v2.getmarvia.com/v1/assets/' \
--header 'Authorization: <api-key>'

Response Example

200 - Example 1

{
    "_tag": "Success",
    "data": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "fileNameOriginal": "string",
        "fileSize": 0,
        "fileExtension": "string",
        "urls": {
            "original": "string",
            "thumbnail": "string",
            "preview": "string",
            "cdnUrl": "string"
        },
        "height": 0,
        "width": 0,
        "imageRights": "string",
        "usageRights": "string",
        "publicationDate": "string",
        "expirationDate": "string",
        "translations": [
            {
                "locale": "string",
                "name": "string",
                "description": "string"
            }
        ],
        "tags": [
            {
                "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
                "translations": [
                    {
                        "locale": "string",
                        "name": "string",
                        "description": "string"
                    }
                ]
            }
        ],
        "aiTags": [
            {
                "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
                "translations": [
                    {
                        "locale": "string",
                        "name": "string",
                        "description": "string"
                    }
                ]
            }
        ],
        "categories": [
            {
                "translations": [
                    {
                        "locale": "string",
                        "name": "string",
                        "description": "string"
                    }
                ]
            }
        ],
        "metaTags": [
            {
                "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
                "translations": [
                    {
                        "locale": "string",
                        "name": "string",
                        "description": "string"
                    }
                ],
                "metaTags": [
                    {
                        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
                        "name": [
                            {
                                "locale": "string",
                                "name": "string",
                                "description": "string"
                            }
                        ],
                        "type": "text",
                        "value": "string"
                    }
                ]
            }
        ],
        "createdAt": "string",
        "editedAt": "string"
    }
}

Modified at 2025-10-01 06:18:21

Create a new asset

Update an asset