---
title: "Update Placement"
method: PATCH
path: "/api/placements/{placement_id}"
tags: ["placements"]
---

# Update Placement

`PATCH /api/placements/{placement_id}`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/placements/{placement_id}`
- Auth: HTTP bearer

Update placement (founder only)

Can update status, dates, etc.

## Path parameters

- `placement_id` string, required

## Request body

- PlacementUpdate: Request model for updating a placement
  - `status` 'Proposed' | 'Signed' | 'Active' | 'Churned', nullable
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `churn_reason` string, nullable
  - `nps_score` integer, nullable
  - `contractor_monthly_cost` integer, nullable: Monthly contractor pay in USD (locked after Deel contract)

## Response `200`

Successful Response

- PlacementResponse: Response model for placement data
  - `id` string, required
  - `client` object, nullable
  - `candidate` object, nullable
  - `role_type` string, required
  - `monthly_rate` integer, required
  - `pricing_tier` string, nullable
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `status` string, required
  - `proposal_url` string, nullable
  - `signed_date` string, date, nullable
  - `first_invoice_paid` boolean
  - `churn_reason` string, nullable
  - `nps_score` integer, nullable
  - `duration_days` integer, nullable
  - `contractor_monthly_cost` integer, nullable
  - `deel_contract_id` string, nullable
  - `payment_provider` string, nullable
  - `gross_margin_dollars` integer, nullable
  - `margin_percent` number, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)