/assets/:assetId/share-links
Changed onList the share links for an asset.
An asset can have one link that follows its current version and one link per pinned version. Older links created from inside a board are listed too, so an asset can have more than one link that follows the current version. Tell them apart by id and createdAt.
Links that follow the current version come first, then pinned links from the newest version to the oldest. If you can't view all of the asset's versions, only links for its current version are returned.
Disabled links are included with active: false. The password is never returned; hasPassword says whether one is set.
Requires the share_links.read and assets.read OAuth scopes.
Request
- Base URLapi.air.inc (relative, and the document’s source URL is not known)
- Auth
- API key in header x-api-key and API key in header x-air-workspace-id
- or HTTP bearer and API key in header x-air-workspace-id
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
The max number of share links to return in the response (default 12, max 200)
Cursor returned in the previous page of responses used to get the next page of results
Response
Share links listed successfully
Changes
- info
endpoint added
- info