curl --request POST \
--url https://api.periskope.app/v1/media/migrate-url \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://storage.googleapis.com/periskope-attachments/2997dd64-89bf-48d3-9a22-b314fca017e5/919876543210/msg_ABCDEF123/file.jpg",
"access": "private",
"expires_in_seconds": 86400
}'
{
"url": "https://api.periskope.app/app/media/periskope-attachments/2997dd64-89bf-48d3-9a22-b314fca017e5%2F919876543210%2Fmsg_ABCDEF123%2Ffile.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"access": "private",
"expires_in_seconds": 86400
}
{
"error": "URL belongs to a different organization"
}
Media APIs
Migrate Media URL
Convert a legacy Google Cloud Storage media URL to the new Periskope media URL format
curl --request POST \
--url https://api.periskope.app/v1/media/migrate-url \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://storage.googleapis.com/periskope-attachments/2997dd64-89bf-48d3-9a22-b314fca017e5/919876543210/msg_ABCDEF123/file.jpg",
"access": "private",
"expires_in_seconds": 86400
}'
{
"url": "https://api.periskope.app/app/media/periskope-attachments/2997dd64-89bf-48d3-9a22-b314fca017e5%2F919876543210%2Fmsg_ABCDEF123%2Ffile.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"access": "private",
"expires_in_seconds": 86400
}
{
"error": "URL belongs to a different organization"
}
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
Body
The media URL to migrate. Either a legacy
storage.googleapis.com attachment URL or an existing Periskope media URL.Access mode for the returned URL. One of
private or public.private— returns a tokenized link that expirespublic— returns a bare link without a token
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
curl --request POST \
--url https://api.periskope.app/v1/media/migrate-url \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{
"url": "https://storage.googleapis.com/periskope-attachments/2997dd64-89bf-48d3-9a22-b314fca017e5/919876543210/msg_ABCDEF123/file.jpg",
"access": "private",
"expires_in_seconds": 86400
}'
{
"url": "https://api.periskope.app/app/media/periskope-attachments/2997dd64-89bf-48d3-9a22-b314fca017e5%2F919876543210%2Fmsg_ABCDEF123%2Ffile.jpg?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"access": "private",
"expires_in_seconds": 86400
}
{
"error": "URL belongs to a different organization"
}
Was this page helpful?