Share a Collection of assets.

Share a Collection, internally or externally.

SecurityOAuth2
Request
path Parameters
collectionId
required
string <uuid> = 36 characters

The Collection Identifier.

Example: f45c87aa-2ff7-4f2c-9c38-9d69554a1c8a
header Parameters
content-type
string
Example: application/json
Authorization
string
Example: Bearer <token>
Request Body schema: application/json
type
string

Type of share, either internal or external. If the user has a Tenovos account, internal share is recommended.

Enum: "internal" "external"
shareOriginal
boolean
Default: false

Whether to share the original file, or a rendition of the original at a lower quality. If true, the original file for every asset in the collection will be shared.

emails
Array of strings <email> [ 1 .. 50 ] items unique

Provide the email addresses to share the Collection with. Whether internal or external, provide one or more emails.

Responses
200

Successful Request. Collection Shared Successfully.

400

One or more required parameters are missing or invalid.

401

Authentication failed (unauthorized).

403

Forbidden. You do not have permissions to perform this action, or your connection information is not correct.

503

The server is too busy to handle the request.

post/share/collections/{collectionId}
Request samples
application/json
{
  • "type": "external",
  • "shareOriginal": true,
  • "emails": [
    ]
}