GET
/v1/file_linksList file links
Lists file links that provide unauthenticated access to File object contents. Use file, expired, and created to filter links, and use cursor parameters to paginate through the results.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
createdobjectoptional
Filter links by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, or `lte`.
ending_beforestringoptional
Cursor identifying the file link before which to return results.
expandarray<string>optional
Fields to expand in the response; each value can contain at most 5000 characters.
expiredbooleanoptional
Filter links by whether they have expired; omit it to return both expired and unexpired links.
filestringoptional
Filter links to those associated with the specified file.
limitintegeroptional
Maximum number of file links to return, from 1 to 100. Defaults to 10 when omitted.
starting_afterstringoptional
Cursor identifying the file link after which to return results.
200Returns a list object containing file-link objects with their expiration state, associated file, URL, metadata, and timestamps, along with pagination metadata.
dataarray<FileLink>required
Details about each object.
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultReturned when the API cannot process the list request; the response contains an error object.
errorobjectrequired
Error handling
limit must be between 1 and 100. Use starting_after or ending_before as object-ID cursors, and provide file as the identifier of the file whose links you want to list.