---
search:
  tags:
    - Operations
    - POST
seo:
  description: >-
    Updates the buyout amount on an offer. The offer must be in "pending" or
    "awaiting_customer"… Reference for the POST /{id}/buyout endpoint in the
    Offers API.
sidebar:
  label: Update offer buyout amount
  badge: POST
title: Update offer buyout amount
type: openapi-operation
---
Updates the buyout amount on an offer. The offer must be in "pending" or "awaiting_customer" status.

`POST /{id}/buyout`

**Request body** (`application/json`)

- `buyoutAmount` (number, required) — Buyout amount in cents (e.g., 50000 = $500.00). Customer can opt to receive this amount instead of a replacement product.

Request body example:

```json
{
  "buyoutAmount": 50000
}
```

**Responses**

- `200` — Offer buyout amount updated successfully
- `400` — Bad request - Offer buyout could not be updated
- `401` — Unauthorized - Missing or invalid authentication
- `403` — Forbidden - Caller can view this offer but is not allowed to update it
- `404` — Not found - Offer does not exist or caller is not allowed to view it
- `500` — Internal server error

Response example, 200:

```json
{
  "success": true,
  "buyoutAmount": 50000,
  "updatedAt": "2024-01-20T12:00:00Z"
}
```

Response example, 400 · offerBuyoutUpdateNotAllowed:

```json
{
  "code": "OFFER_BUYOUT_UPDATE_NOT_ALLOWED",
  "message": "Offer buyout cannot be updated because it is in \"canceled\" status"
}
```

Response example, 400 · updateBuyoutAmountError:

```json
{
  "code": "UPDATE_BUYOUT_AMOUNT_ERROR",
  "message": "Failed to update offer buyout amount"
}
```

Response example, 401:

```json
{
  "code": "UNAUTHORIZED",
  "message": "Missing authentication token"
}
```

Response example, 403 · insufficientScope:

```json
{
  "code": "INSUFFICIENT_SCOPE",
  "message": "The presented token is missing the `write:offers` scope, which this endpoint requires. Create a token with the scopes you need at https://developer.sibipro.com."
}
```

Response example, 403 · permissionDenied:

```json
{
  "code": "FORBIDDEN",
  "message": "User does not have permission to update this offer"
}
```

Response example, 404:

```json
{
  "code": "OFFER_NOT_FOUND",
  "message": "Offer not found"
}
```

Response example, 500:

```json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred"
}
```