# Shared Content

These endpoints are called by **external share recipients** after authenticating via
[Share Authentication](#tag/Share-Authentication). They provide a read-only, scoped
view of the content included in a specific share — no other platform data is accessible.

- `retrieve-shared-documents` — list the documents included in the share, with metadata
- `retrieve-content` — get a pre-signed download URL for a specific shared content item
- `retrieve-branding-content` — fetch branding assets (logo, colors, fonts) associated
  with the share, used to render the share portal with the sender's organization branding


## Get shared documents

 - [POST /api/v1/share-retrieval/retrieve-shared-documents](https://api.tenovos.com/openapi/content-intelligence/shared-content/tenovos.sharing.shareretrievalservice.retrieveshareddocuments.md): Returns the documents included in the share associated with the authenticated share token.

Request:
(no parameters) - The share is identified from the caller's bearer token issued by ExchangeOtp.

Response:
documents      - List of ShareDocument entries, each containing an id and optionally the
full Document object.
expiryTime    - When the share expires.
accessLevel   - The caller's access level for this share (VIEW or VIEW_DOWNLOAD).

## Get shared content

 - [POST /api/v1/share-retrieval/retrieve-content](https://api.tenovos.com/openapi/content-intelligence/shared-content/tenovos.sharing.shareretrievalservice.retrievecontent.md): Generates download URLs for specific content items within the scope of the authenticated share.

Request:
contentIds          - List of content IDs to retrieve URLs for.
representationType  - The content representation to retrieve (e.g. "original", "preview").

Response:
content   - A RetrieveUrl.Response containing presigned download URLs and content properties
for each requested content ID.

## Get branding assets

 - [POST /api/v1/share-retrieval/retrieve-branding-content](https://api.tenovos.com/openapi/content-intelligence/shared-content/tenovos.sharing.shareretrievalservice.retrievebrandingcontent.md): Returns download URLs for the branding content (logo, background, etc.) associated with the share's site.

Request:
(no parameters) - Branding is resolved from the share's site configuration.

Response:
content   - A RetrieveUrl.Response containing presigned download URLs for the site's branding assets.