---
title: "Attach a declarations page to the delegated umbrella session."
method: POST
path: "/api/agent/umbrella/attach"
---

# Attach a declarations page to the delegated umbrella session.

`POST /api/agent/umbrella/attach`

## Request

- Base URL: `https://api.coveragecat.com`
- URL: `https://api.coveragecat.com/api/agent/umbrella/attach`
- Auth: HTTP bearer

Accepts a base64-encoded document (PDF or image) and attaches it to the intake as a declarations page. Use type "declarations" for a home/renters declarations page and "auto_declarations" for an auto declarations page. If both the home and auto declarations are already available, prefer one attach call with `attachments[]` so the shopper only has to approve one upload turn. Call this only after the user has selected a Monoline or Markel offer and the delegated session is in bind or post-select checkout. Sandbox delegated umbrella sessions reject this endpoint with `sandbox_unsupported`.

## Headers

- `Coverage-Cat-API-Version` 'v1'
- `Idempotency-Key` string

## Request body

- union
  - object
    - `attachments` object[]: Upload multiple declarations in one call when both files are already available.
      - `content` string, byte, required: Base64-encoded file content (PDF or image).
      - `filename` string, required: Original filename including extension (e.g. "home_dec.pdf").
      - `type` 'declarations' | 'auto_declarations', required: "declarations" for a home or renters dec page; "auto_declarations" for an auto dec page.
    - `content` string, byte, required: Base64-encoded file content (PDF or image).
    - `filename` string, required: Original filename including extension (e.g. "home_dec.pdf").
    - `sandbox` boolean: Optional sticky sandbox flag. Sandbox delegated umbrella sessions currently reject `attach` with `sandbox_unsupported`; this field is accepted so a client carrying the same request envelope does not fail schema validation first.
    - `type` 'declarations' | 'auto_declarations', required: "declarations" for a home or renters dec page; "auto_declarations" for an auto dec page.
    - `uid` string, required
  - object
    - `attachments` object[], required: Upload multiple declarations in one call when both files are already available.
      - `content` string, byte, required: Base64-encoded file content (PDF or image).
      - `filename` string, required: Original filename including extension (e.g. "home_dec.pdf").
      - `type` 'declarations' | 'auto_declarations', required: "declarations" for a home or renters dec page; "auto_declarations" for an auto dec page.
    - `content` string, byte: Base64-encoded file content (PDF or image).
    - `filename` string: Original filename including extension (e.g. "home_dec.pdf").
    - `sandbox` boolean: Optional sticky sandbox flag. Sandbox delegated umbrella sessions currently reject `attach` with `sandbox_unsupported`; this field is accepted so a client carrying the same request envelope does not fail schema validation first.
    - `type` 'declarations' | 'auto_declarations': "declarations" for a home or renters dec page; "auto_declarations" for an auto dec page.
    - `uid` string, required

## Response `200`

Document attached successfully.

- object
  - `filename` string: Server-assigned storage filename.
  - `status` 'ok'
  - `type` string

## Other responses

- `400`: Invalid request.
- `401`: Invalid or missing API key.
- `404`: Unknown delegated umbrella session.
- `409`: Upload attempted before a Monoline or Markel selection exists.
- `429`: Too many failed authentication attempts or delegated-agent requests. Honor the Retry-After header before retrying.

---

[API](https://skmtc.dev/coveragecat/apis/coverage-cat-delegated-insurance-purchase-apis.md) · [All operations](https://skmtc.dev/coveragecat/apis/coverage-cat-delegated-insurance-purchase-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/coveragecat/apis/coverage-cat-delegated-insurance-purchase-apis/revisions/b80fe29790dc?raw)