---
title: "Replace order"
method: PUT
path: "/v1/Orders/{id}"
tags: ["Orders"]
---

# Replace order

`PUT /v1/Orders/{id}`

Replace an existing order.

## Path parameters

- `id` integer, required

## Request body

- RevAppUpdateModelsOrder
  - `order_id` integer — Primary identifier for this order.
  - `status` 'NOT_SPECIFIED' | 'NEW' | 'SENT' | 'ERROR' | 'CONFIRMED' | 'COMPLETE' | 'CANCELED' | 'HOLD' | 'FLOW_ERROR' | 'PAYMENT_HOLD' | 'LIFELINE_HOLD' | 'JEOPARDY' | 'PROVISIONED' — High level perspective of where the order is in work flow.
  - `process_id` integer — Foreign identifier indicating the process to follow for this order.
  - `due_date` string, date-time — Date the order is due.
  - `effective_date` string, date-time — Effective date of the order status change (if changing).
  - `hold_reason_id` integer — Foreign identifier linking back to the hold reason.
  - `retain_listing` boolean — Indicates if this order will retain listing.
  - `flow_through` boolean — Indicates if this order will attempt to automatically send (flow-through) to the provider in a background process once all requirements are met (including, but not limited to, provider send support).
  - `assigned_to` integer — Foreign identifier indicating a user to which this order is assigned.
  - `pon` string — Purchase Order Number.
  - `fields` RevAppModelsFieldValue[] — List of custom fields and their values.
    - `field_id` integer — Primary identifier for this custom field.
    - `label` string — User-defined identifier representing the custom field.
    - `value` string — Value of the custom field.
    - `links` RevAppComponentsLink[]
      - `rel` string
      - `href` string
  - `links` RevAppComponentsLink[]
    - `rel` string
    - `href` string

## Response `200`

OK

- RevWebAPIModelsSuccess
  - `ok` boolean

## Other responses

- `400` — BadRequest
- `500` — InternalServerError

---

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