URLs

Asset URL Generation

Generate asset URLs

post

Generate URLs for classic assets based on specified types and modes. Assets can be identified by IDs or names.

Authorizations
AuthorizationstringRequired

Customer-scoped API key that automatically determines the customer context for all operations.

Body

Request parameters for generating asset URLs. Either asset_ids or asset_names must be provided to identify the assets.

Note: Asset lookup is automatically scoped to the customer associated with the API token. Assets not belonging to the authenticated customer will be treated as "not found".

asset_idsstring · uuid[] · max: 100Optional

Array of asset UUIDs to generate URLs for.

asset_namesstring[] · max: 100Optional

Array of asset names to generate URLs for.

Responses
200

URLs generated successfully

application/json
post
/assets/urls
POST /api/classic/assets/urls HTTP/1.1
Host: console.studio360.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 174

{
  "asset_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ],
  "types": [
    "universal",
    "personalized"
  ],
  "url_modes": [
    "default",
    "thumbnail",
    "embed"
  ]
}
{
  "assets": [
    {
      "asset_name": "DIAMOND-001",
      "asset_id": "550e8400-e29b-41d4-a716-446655440000",
      "urls": [
        {
          "type": "universal",
          "mode": "default",
          "url": "https://console.studio360.tech/v/550e8400-e29b-41d4-a716-446655440000"
        },
        {
          "type": "universal",
          "mode": "thumbnail",
          "url": "https://console.studio360.tech/t/550e8400-e29b-41d4-a716-446655440000"
        }
      ]
    }
  ],
  "errors": [
    {
      "asset_name": "INVALID-ASSET",
      "error": "Asset not found"
    },
    {
      "asset_id": "123e4567-e89b-12d3-a456-426614174000",
      "error": "Asset is archived and cannot generate URLs"
    }
  ]
}
PreviousAssetsNextDownloads

Last updated