# Share a selection of Assets.

Share a selection of Assets to a user specified by Email address.

The user sharing the Assets must be granted the Download Security Template permission on the Assets being shared.

Average Response Time: 195ms

Endpoint: POST /asset/share
Version: 1.5
Security: ApiKeyAuth, BasicAuth

## Header parameters:

  - `X-API-Key` (string, required)
    Customer-specific API key required to invoke API.

  - `Authorization` (string, required)
    Provided by Authentication Token creation operation

  - `Content-Type` (string, required)
    Enum: "application/json"

## Request fields (application/json):

  - `sender` (object)
    Sender information to use in the email

  - `sender.name` (string)
    Sender's name
    Example: "John"

  - `shareUsers` (array)
    A list of users to share assets with

  - `shareUsers.email` (string)
    Recipient's email

  - `shareUsers.name` (string)
    Recipient's name
    Example: "Jeff"

  - `assets` (array)
    List of Asset object IDs to be shared

  - `shareMessage` (string)
    An email message.
    Example: "A message from sender to recipient"

## Response 200 fields (application/json):

  - `message` (string)
    Example: "Message sent successfully"

  - `status` (string)
    status of the request, success or failure

## Response 403 fields (application/json):

  - `status` (string)
    Example: "error"

  - `message` (string)
    Example: "Detailed Message"