The way file URLs are serialized in all API responses has changed as of API version
v2023-01-05. This change affects how you use file URLs returned from an API response to download files, and alters the level of access control embedded in the file URLs.
File URLs were of the form
https://withpersona.com/api/v1/files/[token]/[filename].[extension], and required a Persona API key in the request header to access them.
File URLs are of the form
https://files.withpersona.com/[filename].[extension]?access_token=[token]. A Persona API key is not needed.
For more information about the new URL format, see Downloading Files.
The Download a File API remains unchanged for previous API versions. (Note that this link references the
If you save URLs returned from API responses for use beyond 6 hours into the future, going forward, you will need to account for URLs expiring after 6 hours.