Create Hybrid Share

Create a combinable link in one call: folders/people scope (auto-updating) AND/OR manually-selected images. Scope requires a concrete projectId; explicit-only images may be cross-project (representative project is stored, like /createShareLink).

With scopeLinkMode="per_selected_item", every selected person/folder becomes an independent link regardless of category. All rows are created in the same transaction.

post/shares/create

Request body

projectIdinteger nullable
imageIdsstring[]
personIdsstring[]
personFieldValueIdsstring[]
personFieldPresentation'combined' | 'per_person' | 'combined_and_people'
folderNamesstring[]
folderCategoriesobject
folderLinkMode'combined' | 'per_folder' nullable
scopeLinkMode'combined' | 'per_selected_item' nullable
mode'per_person' | 'all_in_one' nullable
labelstring nullable
titlestring nullable
descriptionstring nullable
includedLabelstring nullable
expiresInDaysinteger nullable
passwordstring nullable
categorystring nullable
creatorDisplaystring nullable

Response

Successful Response

{"stackTrail":"paths:/shares/create:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.