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

bearerAuth

AuthorizationstringRequired

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

Body

application/json

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".

anyOptional

or

anyOptional

Responses

200

URLs generated successfully

application/json

403

Unauthorized

application/json

404

No valid assets found for the provided identifiers.

application/json

422

Unprocessable Entity

application/json

post

/assets/urls

HTTPcURLJavaScriptPython

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"
    }
  ]
}