# 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](/docs/posting/create-posts/content-types.md)
* [Publishing Methods](/docs/posting/create-posts/publishing-methods.md)
* [Media Handling](/docs/posting/create-posts/media-handling.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://publer.com/docs/posting/create-posts/media-options.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.