Add Share Asset

Add one share for the asset (SSE): grant right (READ by default) to either a group (group_id) or a user (email). If the asset is a folder, applies to the folder and all underlying assets. Caller must be able to share it (ADMIN, or a share with can_share); only ADMIN can set can_share.

post/asset/{asset_id}/share/add

Request

  • Base URL
    https://api.tellers.ai (the document declares no server; this is the origin it was published from)
  • Auth
    none declared

Path parameters

asset_idstring uuid required

Headers

x-api-keystring nullable
authorizationstring nullable

Request body

group_idstring uuid nullable
emailstring nullable
can_shareboolean

Let the grantee share the asset onward too. Only an admin of the asset can set it.

rightstring nullable

VIEW, READ, WRITE or ADMIN; null means READ. VIEW sees the file and everything about it except its comments. Below ADMIN, a sharer hands out at most their own right. An existing share keeps its right: change it with share/update_right.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.