Embedding tinted background watermarks into PDF files



This operation supports creating and embedding one or more watermarks (created with Link Creation Studio®) to the background of a set of pages in a PDF file.

Each watermark will first be applied to a gray-tinted background (configurable with the background_tint parameter), and then embedded into the background layer of the desired page in the PDF file.

A Live Paper Platform token is required (lpp_access_token) to generate the watermarks, as well as the resolution and strength param and strength parameters from the Link Creation Studio API. Trigger description URLs are also expected for each watermark as the trigger_watermark_url parameters.

eters from the Link Creation Studio API. Trigger description URLs are also expected for each watermark as the trigger_watermark_url parameters.

 

A Live Paper Platform token is required (lpp_access_token) to generate the watermarks, as well as the resolution


  • Endpoint: POST http://mu3.hp-mu.com/jobs/sync
  • Authorization: BASIC bXVscHA6eGhDdGNxNW9U
  • Accept-type: application/json
  • Content-type: application/json
  • Input schema sample: (For embedding two background watermarks to pages 1 and 2 of a PDF file with strength value 10, 75dpi resolution and 0.1% gray background tinting.)
{
    "workflow": [
        {
            "task": "EmbedBackgroundWatermark",
            "inputs": {
                "pdf": "http://url.pdf",
                "lpp_access_token": "NmV2ODJ1dmZ3c281bDRhbGh2...",
                "resolution": 75,
                "strength": 10,
                "background_tint": "0.1%",
                "embedded_pairs": [
                    {
                        "trigger_watermark_url": "URL",
                        "page_num": 1
                    },
                    {
                        "trigger_watermark_url": "URL",
                        "page_num": 2
                    }
                ]
            }
        }
    ]
}
  • Output schema sample:
{
    "id": "5501a92417d07f9096f530bd",
    "status": "success",
    "workflow": [
        {
            "task": "EmbedBackgroundWatermark",
            "inputs": {
                "pdf": "http://url.pdf",
                "lpp_access_token": "NmV2ODJ1dmZ3c281bDRhbGh2...",
                "resolution": 75,
                "strength": 10,
                "background_tint": "0.1%",
                "embedded_pairs": [
                    {
                        "trigger_watermark_url": "URL",
                        "page_num": 1
                    },
                    {
                        "trigger_watermark_url": "URL",
                        "page_num": 2
                    }
                ]
            },
            "result": {
                "pdf": "https://mu3.s3.amazonaws.com/123.pdf"
            }
        }
    ]
}