---
title: "Apply Azure exchange recommendations"
method: POST
path: "/v1/org/{org_id}/exchanges/recommendations/apply"
tags: ["Exchanges"]
---

# Apply Azure exchange recommendations

`POST /v1/org/{org_id}/exchanges/recommendations/apply`

Requests application of one Azure reservation exchange recommendation using the same explicit purchase and return item body as the beta exchange endpoint. Currently only provider=azure is supported.

## Request body

- ApplyExchangeRecommendationsArgs
  - `provider` 'aws' | 'azure' | 'gcp', required — Cloud provider (aws, azure, gcp)
  - `purchases` ApplyExchangePurchase[], required — Explicit purchase-side line items for one exchange recommendation.
    - `offer_id` string, uuid, required — Azure reservation offer ID to purchase.
    - `quantity` integer, required — Quantity of this offer to purchase.
  - `returns` ApplyExchangeReturn[], required — Explicit return-side line items for one exchange recommendation.
    - `commitment_id` string, uuid, required — Existing Azure commitment ID to return.
    - `quantity` integer, required — Quantity of this commitment to return.

## Response `200`

OK

- ApplyExchangeRecommendationsResponse
  - `status` string, required — Application status for the exchange recommendations.
  - `recommendation_count` integer, required — Number of exchange recommendations applied.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `405` — Method not allowed
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal server error
- `default` — Default error response

---

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