Skip to main content
This endpoint converts up to 1000 legacy storage.googleapis.com attachment URLs (or existing Periskope media URLs) to the new Periskope media URL format in a single request. Each URL succeeds or fails independently — results[i] in the response corresponds to urls[i] in the request, so one invalid URL does not fail the whole batch.
All media files must belong to the organization of the API key used. URLs from other organizations or non-Periskope buckets fail individually with an error in their result entry.

Headers

string
required
Bearer token with your API key e.g. Bearer <api_key>

Body

string[]
required
The media URLs to migrate. Maximum 1000 URLs per request.
string
Access mode for the returned URLs. One of private or public.
  • private — returns tokenized links that expire
  • public — returns bare links without a token
If omitted, follows your organization’s Media Privacy setting.
number
Validity of the returned links in seconds. Only valid for private links — returns an error if passed for public links. Clamped between 60 (1 minute) and 604800 (7 days). Defaults to your organization’s configured link expiry (24 hours unless changed). A single token is minted and shared across all URLs in the batch.

Response

object[]
One result per input URL, in the same order as the request.
number
Number of URLs migrated successfully.
number
Number of URLs that failed to migrate.
string
The access mode applied to the returned URLs — private or public.
number
Validity of the returned links in seconds. Only present for private links.