GET, POST

/api/public/v1/shares

Beta

List shares, or create a link share (or a share with a member). Needs the Advanced Sharing feature enabled for the organization.

Parameters

NameInRequiredDescription
statusqueryfalseactive, expired, revoked or exhausted.
documentIdqueryfalseOnly shares of this document.
limit, beforequeryfalsePage size (max 100) and a cursor.
documentId, expiresAt or expirationPreset, optionsbody (POST)trueA link share. With memberEmail and permission it is a share with a member instead.

Response

GET: { shares[], next }. POST: 201 with the share; the link token is returned once and never listed again.

Example

curl -H "Authorization: Bearer $INAYA_API_KEY" \
  "https://app.inaya.network/api/public/v1/shares"