File link basics
Learn more about the files resource.
Last updated
Learn more about the files resource.
Last updated
You can create a file link when you want to share the contents of a object with a customer. If you want unauthenticated access to a file that a customer can download, you can create a link containing a URL pointing to the file and then send it to the customer.
When you create a file link, we also update the associated file to include the file link's identifier. The file can have an array of file links showing the relationship between the file and file links, including the file link you just created.
When you create a File Link, you'll need to provide the required parameters listed in the following table. The remaining parameters are optional:
fileId
Required
The file identifier.
expiresTime
Required
A future timestamp, after which the link will no longer be usable.
metadata
Optional
Additional structured information for the object.
Create a object with a POST
request:
A 201 Created
response returns a File Link object: