---
title: "Automatable Contract Amendment"
method: POST
path: "/v1/contract-amendments/automatable"
tags: ["Contract Amendments"]
---

# Automatable Contract Amendment

`POST /v1/contract-amendments/automatable`

Check if a contract amendment request is automatable.
If the contract amendment request is automatable, then after submission, it will instantly amend the employee's contract
and send them an updated document.

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 [Contract Amendments](#tag/Contract-Amendments) 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 form 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.



## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage employments (`employments`) | - | Manage contract amendments (`contract_amendment:write`) |

## Query parameters

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

## Headers

- `Authorization` string, required

## Request body

- CreateContractAmendmentParams
  - `amendment_contract_id` string, required — The contract ID of the contract that needs to be amended.
  - `contract_amendment` object, required — Contract amendment informations. As its properties may vary depending on the country, you must query the [Show form schema](#tag/Contract-Amendments/operation/post_show_form_contract_amendment_schema) endpoint passing the country code, `contract_amendment` and the employment ID as request body.
  - `employment_id` string, required — The employment ID that is related to the contract amendment request.

## Response `200`

Success

- ContractAmendmentAutomatableResponse — Contract Amendment Automatable response
  - `data` object
    - `automatable` boolean — If true, it means that the contract amendment request is automatable.
    - `message` string — The message to explain how the contract amendment request will be processed depending if it is automatable or not.

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `422` — 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)