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

```plaintext
get
https://app.publer.com/api/v1/workspaces/{workspace_id}/media_options
```

Retrieves albums and watermarks for specified accounts in a workspace.

#### Authorizations

- **BearerApiAuth**
- `Authorization: string Required`

API key authentication. Format: "Bearer-API YOUR_API_KEY"

#### Path parameters

- **workspace_id**: string Required - ID of the workspace to retrieve media options from

#### Query parameters

- **accounts**: string[] Required - Array of account IDs to filter media options by

#### Responses

- **200**: Successful operation
    - **application/json**
        - `id`: string Optional
        - `albums`: object[] Optional
        - `watermarks`: object[] Optional

- **401**: Unauthorized
    - **application/json**
- **403**: Permission denied
    - **application/json**

```plaintext
get
/workspaces/{workspace_id}/media_options
```

#### HTTP cURL JavaScript Python

```plaintext
GET /api/v1/workspaces/{workspace_id}/media_options?accounts=text HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Accept: */*
```

### Test it

#### Responses

- **200**: Successful operation

```json
[
  {
    "id": "text",
    "albums": [
      {
        "id": "text",
        "name": "text",
        "type": "text"
      }
    ],
    "watermarks": [
      {
        "id": "text",
        "name": "text",
        "opacity": 1,
        "size": 1,
        "position": "text",
        "default": true,
        "image": "text"
      }
    ]
  }
]
```

### Parameters

| Field          | Type    | Description                                                        |
|----------------|---------|--------------------------------------------------------------------|
| `id`           | string  | Account ID                                                         |
| `albums`       | array   | List of albums (Facebook) or boards (Pinterest)                  |
| `albums[].id`  | string  | Album or board ID                                                  |
| `albums[].name`| string  | Album or board name                                               |
| `albums[].type`| string  | "facebook" or "pinterest"                                       |
| `watermarks`   | array   | List of watermark objects                                          |
| `watermarks[].id` | string| Watermark ID                                                      |
| `watermarks[].name` | string| Watermark name                                                  |
| `watermarks[].opacity` | number | Opacity percentage (0–100)                                    |
| `watermarks[].size` | number | Relative size percentage (e.g., 15 = 15%)                      |
| `watermarks[].position` | string | Position on media (e.g., `bottom_right`)                      |
| `watermarks[].default` | boolean | Whether this is the default watermark                           |
| `watermarks[].image` | string | URL to the watermark image                                      |

### 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.