---
title: "prepareServiceBinding"
method: POST
path: "/platform/deployments/custom/{id}/prepare-binding"
tags: ["Platform"]
---

# prepareServiceBinding

`POST /platform/deployments/custom/{id}/prepare-binding`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/deployments/custom/{id}/prepare-binding`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Deploy scope. Prepare a 15-minute review connecting this image-mode custom application to a PostgreSQL or MariaDB catalog provider of the same server and project environment: a dedicated database and login, DATABASE_URL delivered to the agent only, never a secret in the review. Optional wire: true — on apply, every OTHER eligible web/worker component of the same environment receives its OWN binding to the same provider (its own credential, generation and deploy job); components already bound, busy or ineligible are skipped and named in the receipt, never a failure. 201 with plan_id and review_digest. Apply through the saved binding-plan apply route.

## Path parameters

- `id` string, required

## Request body

- object
  - `provider_deployment_id` string, required
  - `wire` boolean: Fan the connection out to every eligible web/worker component of the environment on apply, one binding each.

## Response `201`

Review with plan_id, review_digest, expiry and the reviewed changes (wire_components when wire is set)

## Other responses

- `400`: Invalid input
- `403`: Required scope missing
- `404`: Application
- `409`: Not eligible: already bound, pending operation, or conflicting association
- `429`: Pending review quota reached
- `503`: Storage or verification unavailable

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)