---
title: "Updates a Benefit Renewal Request Response"
method: POST
path: "/v1/benefit-renewal-requests/{benefit_renewal_request_id}"
tags: ["Benefit Renewals"]
---

# Updates a Benefit Renewal Request Response

`POST /v1/benefit-renewal-requests/{benefit_renewal_request_id}`

Updates a Benefit Renewal Request with the given response.

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | - | Manage benefit renewals (`benefit_renewal:write`) |

## Path parameters

- `benefit_renewal_request_id` string, uuid, required — Identifier of the employment being terminated.

## Query parameters

- `json_schema_version` union
  - integer — Specific version number
  - 'latest' — Use latest version

## Headers

- `Authorization` string, required

## Request body

- BenefitRenewalRequestsUpdateBenefitRenewalRequest — Upsert benefit offers Renewal Request. This endpoint requires and returns country-specific data. The exact required and returned fields will vary depending on which country the employment is in. To see the list of parameters for each country, see the **Show form schema** endpoint under the [Show benefit renewal request schema](#tag/Benefit-Renewal-Requests) category. Please note that the compliance requirements for each country are subject to change according to local laws. Given its continual updates, using Remote's [json-schema-form](https://developer.remote.com/docs/how-json-schemas-work) should be considered in order to avoid compliance issues and to have the latest version of a country requirements. If you are using this endpoint to build an integration, make sure you are dynamically collecting or displaying the latest parameters for each country by querying the _"Show benefit renewal request schema"_ endpoint. For more information on JSON Schemas, see the **How JSON Schemas work** documentation. To learn how you can dynamically generate forms to display in your UI, see the documentation for the [json-schema-form](https://developer.remote.com/docs/how-json-schemas-work) tool.

## Response `200`

Success

- SuccessResponse — A generic success response returned by operations that don't produce a specific resource (e.g., updates, deletes).
  - `data` object, required
    - `status` string — The result status. Always `"ok"` for successful operations.

## Other responses

- `401` — Unauthorized
- `422` — Unprocessable Entity
- `429` — Unprocessable Entity

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)