---
title: "Transfer a concierge order to provider(s)"
method: POST
path: "/v1/orders/{orderId}/transfer"
tags: ["Orders"]
---

# Transfer a concierge order to provider(s)

`POST /v1/orders/{orderId}/transfer`

Concierge action. Assigns an order to one or more fulfilling providers, releases it to order_sent, notifies the assigned provider(s), and emits the PHI-free order_reassigned event. Works for the initial pending_review release and for re-routing any non-terminal order to a different provider (terminal orders are rejected with 409). Requires the provider-relations (or super-admin) role.

## Path parameters

- `orderId` string, required

## Request body

- object
  - `providerIds` string[], required — One or more provider ids to assign the order to. The order item(s) are assigned to the first provider.

## Response `200`

Default Response

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/ae97a9add0ba/schema)