Check for Duplicate Asset

POST

/uploads/check-duplicate

Searches within the authenticated account's scope for an existing asset matching the given SHA-256 checksum and optional byte size.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Duplicate detection result

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/uploads/check-duplicate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "checksum_sha256": "string",
    "size": 0
}'

Response Example

200 - Example 1

{
    "duplicate": true,
    "asset": {
        "id": "asset_01HXYZ...",
        "status": "active",
        "filename": "hero.png",
        "content_type": "image/png",
        "size": 245817,
        "checksum_sha256": "string",
        "privacy": "public",
        "direct_url": "https://files.media2url.com/media/hero.png",
        "share_url": "https://media2url.com/m/hero",
        "temporary": true,
        "expires_at": "2019-08-24T14:15:22.123Z",
        "trial_remaining": 0,
        "embeds": {
            "markdown": "string",
            "html": "string",
            "css": "string"
        },
        "created_at": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2026-10-11 18:32:15

Finalize Upload & Promote Asset

List Assets