Go to website

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:

  • Organize 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

get

Retrieves albums and watermarks for specified accounts in a workspace.

Authorizations
Path parameters
workspace_idanyRequired

ID of the workspace to retrieve media options from

Query parameters
accountsanyRequired

Array of account IDs to filter media options by

Responses
200
Successful operation
application/json
get
GET /api/v1/workspaces/{workspace_id}/media_options HTTP/1.1
Host: app.publer.com
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "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.

Related Topics

PreviousMedia HandlingNextNetworks

Last updated

Was this helpful?