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

get

Retrieves albums and watermarks for specified accounts in a workspace.

Authorizations

BearerApiAuth

AuthorizationstringRequired

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

Path parameters

workspace_idstringRequired

ID of the workspace to retrieve media options from

Query parameters

accountsstring[]Required

Array of account IDs to filter media options by

Responses

200

Successful operation

application/json

401

Unauthorized

application/json

403

Permission denied

application/json

get

/workspaces/{workspace_id}/media_options

HTTPcURLJavaScriptPython

GET /api/v1/workspaces/{workspace_id}/media_options?accounts=text 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

• Content Types

• Publishing Methods

• Media Handling