---
title: "Prepare the highest-priority existing-page proposal"
method: POST
path: "/api/v2/onsite-proposals"
tags: ["Own-site execution"]
---

# Prepare the highest-priority existing-page proposal

`POST /api/v2/onsite-proposals`

## Request

- Base URL: `https://www.hireeli.io`
- URL: `https://www.hireeli.io/api/v2/onsite-proposals`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Selects a measured losing buyer question and matching verified owned page, or reuses unfinished work. It creates a reviewable proposal only and never approves or applies it.

## Headers

- `x-eli-tenant` string, uuid

## Response `200`

A proposal was prepared/reused, or no safe match was available.

- OnsiteProposalResponse
  - `decision` 'prepare', required
  - `resourceId` string, required
  - `status` 'ready' | 'no_match' | 'connection_required', required
  - `prepared` boolean, required
  - `selected` object, required
    - `changeId` string, uuid, nullable, required
    - `promptId` string, uuid, nullable, required
    - `pageUrl` string, uri, nullable, required
    - `reused` boolean, required
    - `workflowStatus` 'draft' | 'approved' | 'applying' | 'reverting', nullable, required
    - `applicationMode` 'native_wordpress' | 'manual_cms_handoff', nullable, required
  - `previewEndpoint` string, nullable
  - `decisionEndpoint` string, nullable
  - `approvalRequired` boolean, required
  - `nextAction` 'approve' | 'apply' | 'publish_handoff_then_verify' | 'wait', nullable, required
  - `nextActionHint` string, nullable
  - `changedByThisRequest` false, required
  - `caps` object, nullable
  - `audit_id` string, uuid, nullable

## Other responses

- `401`: Credential missing, invalid, expired or revoked.
- `403`: Workspace, role, scope, plan or feature does not permit this operation.
- `429`: Request or durable protocol cap reached.
- `503`: A required security, billing, cap, audit, evidence or storage check is unavailable. Writes fail closed.

---

[API](https://skmtc.dev/hireeli/apis/eli-api.md) · [All operations](https://skmtc.dev/hireeli/apis/eli-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hireeli/apis/eli-api/revisions/3272729fecd2?raw)