Method Details
HTTP Methods:
GET
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing & CRM
Required Scope:
Get the details for a private file. The details will include a signed URL that can be used to retrieve the contents of the file.
Private files cannot be access using their URL alone. The signed URL returned by this endpoint can be used to get temporary access to the file contents.
Notes:
- When using OAuth for your authentication, files that are both private and hidden cannot be accessed without the
files.ui_hidden.readscope. See the details below. - The signed URL will only be valid for a few hours, after which the URL will result in an error. At this point, you would need to request a new signed URL to access the file again. The
expiresAtfield in the response is a UNIX-formatted timestamps in milliseconds that represents the time that the URL will expire.