Skip to main content
This endpoint converts a legacy storage.googleapis.com attachment URL to the new Periskope media URL format (https://api.periskope.app/app/media/...). You can also pass an existing Periskope media URL to refresh its access token — useful when a private link has expired and you need a fresh one.
The media file must belong to the organization of the API key used. URLs from other organizations or non-Periskope buckets will return an error.

​
Headers

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

​
Body

​
string
required
The media URL to migrate. Either a legacy storage.googleapis.com attachment URL or an existing Periskope media URL.
​
string
Access mode for the returned URL. One of private or public.
  • private — returns a tokenized link that expires
  • public — returns a bare link without a token
If omitted, follows your organization’s Media Privacy setting.
​
number
Validity of the returned link in seconds. Only valid for private links — returns an error if passed for a public link. Clamped between 60 (1 minute) and 604800 (7 days). Defaults to your organization’s configured link expiry (24 hours unless changed).

​
Response

​
string
The migrated Periskope media URL. Includes an access token (?jwt=...) when access is private.
​
string
The access mode applied to the returned URL — private or public.
​
number
Validity of the returned link in seconds. Only present for private links.