CreatePdfFromUrlBody

The `CreatePdfFromUrlBody` entity.

Definition

TypeScript

interface CreatePdfFromUrlBody {
  workspaceId: string;
  url: string;
  directoryId?: string | undefined;
  name?: string | undefined;
  ttlMs?: number | null | undefined;
  browser?:
    | {
        viewport?: { width: number; height: number } | undefined;
        waitForSelector?:
          | {
              selector: string;
              hidden?: boolean | undefined;
              timeout?: number | undefined;
            }
          | undefined;
        waitForTimeout?: number | undefined;
        userAgent?: string | undefined;
        authenticate?: { username: string; password: string } | undefined;
        cookies?:
          | Array<{
              [x: string]: unknown;
              name: string;
              value: string;
              url?: string | undefined;
              domain?: string | undefined;
              path?: string | undefined;
            }>
          | undefined;
        extraHeaders?: Record<string, string> | undefined;
        gotoOptions?:
          | {
              waitUntil?:
                | "load"
                | "domcontentloaded"
                | "networkidle0"
                | "networkidle2"
                | undefined;
              timeout?: number | undefined;
              referer?: string | undefined;
            }
          | undefined;
        bestAttempt?: boolean | undefined;
        allowRequestPattern?: Array<string> | undefined;
        rejectRequestPattern?: Array<string> | undefined;
        allowResourceTypes?: Array<string> | undefined;
        rejectResourceTypes?: Array<string> | undefined;
        setJavaScriptEnabled?: boolean | undefined;
      }
    | undefined;
  pdf?:
    | {
        format?: string | undefined;
        landscape?: boolean | undefined;
        scale?: number | undefined;
        printBackground?: boolean | undefined;
        displayHeaderFooter?: boolean | undefined;
        headerTemplate?: string | undefined;
        footerTemplate?: string | undefined;
        margin?:
          | {
              top?: string | undefined;
              right?: string | undefined;
              bottom?: string | undefined;
              left?: string | undefined;
            }
          | undefined;
        width?: string | undefined;
        height?: string | undefined;
        preferCSSPageSize?: boolean | undefined;
      }
    | undefined;
}

Fields

Field	Type	Notes
`workspaceId`	`string`	`required` — Workspace that will own the generated PDF.
`url`	`string`	`required` — URL to render as a PDF.
`directoryId`	`string \| undefined`	`optional` — Destination directory. Defaults to the workspace root. When omitted the file defaults to temp (1 day TTL); when set the file is permanent unless `ttlMs` is also provided.
`name`	`string \| undefined`	`optional` — Filename. Defaults to `<hostname>-<yyyy-mm-dd>.pdf` derived from the URL.
`ttlMs`	`number \| null \| undefined`	`optional`
`browser`	{ viewport?: { width: number; height: number; } \| undefined; waitForSelector?: { selector: string; hidden?: boolean \| undefined; timeout?: number \| undefined; } \| undefined; waitForTimeout?: number \| undefined; userAgent?: string \| undefined; authenticate?: { username: string; password: string; } \| undefined; cookies?: Array<{ [x: string]: unknown; name: string; value: string; url?: string \| undefined; domain?: string \| undefined; path?: string \| undefined; }> \| undefined; extraHeaders?: Record<string, string> \| undefined; gotoOptions?: { waitUntil?: "load" \| "domcontentloaded" \| "networkidle0" \| "networkidle2" \| undefined; timeout?: number \| undefined; referer?: string \| undefined; } \| undefined; bestAttempt?: boolean \| undefined; allowRequestPattern?: Array<string> \| undefined; rejectRequestPattern?: Array<string> \| undefined; allowResourceTypes?: Array<string> \| undefined; rejectResourceTypes?: Array<string> \| undefined; setJavaScriptEnabled?: boolean \| undefined; } \| undefined	`optional` — Shared browser render options (viewport, waits, auth, etc.).
`pdf`	`{ format?: string \| undefined; landscape?: boolean \| undefined; scale?: number \| undefined; printBackground?: boolean \| undefined; displayHeaderFooter?: boolean \| undefined; headerTemplate?: string \| undefined; footerTemplate?: string \| undefined; margin?: { top?: string \| undefined; right?: string \| undefined; bottom?: string \| undefined; left?: string \| undefined; } \| undefined; width?: string \| undefined; height?: string \| undefined; preferCSSPageSize?: boolean \| undefined; } \| undefined`	`optional` — PDF-specific options (page format, margins, print background, …).