---
title: "Present Proposal Layout"
method: POST
path: "/estimate/{estimate_uid}/present"
---

# Present Proposal Layout

`POST /estimate/{estimate_uid}/present`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/estimate/{estimate_uid}/present`
- Auth: API key in header `x-api-key`

Generates a PDF/HTML rendering of a proposal's layout. Requires the company's layout_template policy to be enabled, the estimate must have `is_proposal: true`, and have a layout association configured. Runs fully synchronously (PDF generation + upload happen in-request, no job queue).

If the proposal has already reached APPROVED or AWAIT_SIGNATURE, only `proposal_options` marked `is_accepted: true` are rendered (post-approval, present shows only the winning option).

`send_buffer: true` bypasses the normal JSON envelope entirely and returns raw HTML directly.

## Path parameters

- `estimate_uid` string, required

## Request body

- object
  - `send_html` boolean: Returns JSON with pages/meta populated instead of a signed PDF URL.
  - `send_buffer` boolean: Returns raw HTML (Content-Type: text/html) instead of the standard JSON response.

## Response `200`

200

- object
  - `status` boolean
  - `type` string
  - `data` object
    - `proposal_pdf_link` string: A 12-hour signed S3 URL. Present only for the default (non-send_html, non-send_buffer) mode.
    - `layout_config` object
      - `acknowledgment_pages` unknown[]
        - unknown
      - `proposal_options` unknown[]
        - unknown
    - `pages` unknown[]: Present only when send_html is true.
      - unknown
    - `meta` object: Present only when send_html is true.

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/estimate/:estimate_uid/present/post.md)

---

[API](https://skmtc.dev/zuper/apis/zuper-pro-api.md) - [All operations](https://skmtc.dev/zuper/apis/zuper-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zuper/apis/zuper-pro-api/revisions/3c21bc232e16?raw)
