# Media Options

Manage and retrieve Facebook albums, Pinterest boards, and saved watermarks for your social accounts—all within your workspace. Use these options to organize content and protect your creative assets.

### Overview

Media options help you:

* **Post** your Facebook photos into albums.
* **Pin** to specific Pinterest boards.
* **Protect** your images and videos with custom watermarks.

Retrieve all available albums/boards and watermarks per account to use in your post scheduling workflows.

### Fetch Media Options

Use the following endpoint to list all available albums (for Facebook), boards (for Pinterest), and saved watermarks for the accounts in your workspace.

## Get Media Options

> Retrieves albums and watermarks for specified accounts in a workspace.

```json
{"openapi":"3.1.1","info":{"title":"Publer API","version":"1.0.0"},"tags":[{"name":"Workspaces","description":"Endpoints for managing workspaces and teams"}],"servers":[{"url":"https://app.publer.com/api/v1"}],"security":[{"BearerApiAuth":[]}],"components":{"securitySchemes":{"BearerApiAuth":{"type":"apiKey","name":"Authorization","in":"header","description":"API key authentication. Format: \"Bearer-API YOUR_API_KEY\""}},"schemas":{"401ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}},"403ErrorResponse":{"type":"object","properties":{"errors":{"type":"array","description":"List of error messages","items":{"type":"string"}}}}}},"paths":{"/workspaces/{workspace_id}/media_options":{"get":{"summary":"Get Media Options","description":"Retrieves albums and watermarks for specified accounts in a workspace.","tags":["Workspaces"],"parameters":[{"schema":{"type":"string"},"name":"workspace_id","in":"path","description":"ID of the workspace to retrieve media options from","required":true},{"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":false,"name":"accounts","in":"query","description":"Array of account IDs to filter media options by","required":true}],"responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"albums":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"}}}},"watermarks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"opacity":{"type":"number"},"size":{"type":"number"},"position":{"type":"string"},"default":{"type":"boolean"},"image":{"type":"string","format":"url"}}}}}}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/401ErrorResponse"}}}},"403":{"description":"Permission denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/403ErrorResponse"}}}}}}}}}
```

### Parameters

<table><thead><tr><th width="214.99017333984375">Field</th><th width="95.99688720703125">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td>string</td><td>Account ID</td></tr><tr><td><code>albums</code></td><td>array</td><td>List of albums (Facebook) or boards (Pinterest)</td></tr><tr><td><code>albums[].id</code></td><td>string</td><td>Album or board ID</td></tr><tr><td><code>albums[].name</code></td><td>string</td><td>Album or board name</td></tr><tr><td><code>albums[].type</code></td><td>string</td><td><code>"facebook"</code> or <code>"pinterest"</code></td></tr><tr><td><code>watermarks</code></td><td>array</td><td>List of watermark objects</td></tr><tr><td><code>watermarks[].id</code></td><td>string</td><td>Watermark ID</td></tr><tr><td><code>watermarks[].name</code></td><td>string</td><td>Watermark name</td></tr><tr><td><code>watermarks[].opacity</code></td><td>number</td><td>Opacity percentage (0–100)</td></tr><tr><td><code>watermarks[].size</code></td><td>number</td><td>Relative size percentage (e.g., 15 = 15%)</td></tr><tr><td><code>watermarks[].position</code></td><td>string</td><td>Position on media (e.g., <code>bottom_right</code>)</td></tr><tr><td><code>watermarks[].default</code></td><td>boolean</td><td>Whether this is the default watermark</td></tr><tr><td><code>watermarks[].image</code></td><td>string</td><td>URL to the watermark image</td></tr></tbody></table>

### How to Use Media Options

* **Facebook Albums**: Select an album ID when posting to Facebook to keep your photos organized and easy to browse.
* **Pinterest Boards**: Use the board ID to specify where your Pin should be published.
* **Watermarks**: Choose a watermark ID to apply a logo, copyright, or brand mark to your images/videos. Watermarks help deter unauthorized use and reinforce your brand.

### Related Topics

* [Content Types](https://publer.com/docs/posting/create-posts/content-types)
* [Publishing Methods](https://publer.com/docs/posting/create-posts/publishing-methods)
* [Media Handling](https://publer.com/docs/posting/create-posts/media-handling)