Remote Contract Amendments API

Submit and track contract amendments

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /contract_amendments List contract amendments · List Contract Amendments #
Ask an LLM
“Which contract changes have been requested for my employees?”
“Can I filter contract amendments by employee or status?”
Tell an agent
List contract amendments for employment {employment_id}.
Show contract amendments with status {status}.
POST /contract_amendments Request a contract amendment · Create A Contract Amendment #
Ask an LLM
“How do I request a change to an employee's contract starting on a certain date?”
“Can I submit a contract amendment for manual review by Remote?”
Tell an agent
Request a contract amendment for employment {employment_id} effective {effective_date}.
Amend the contract of employment {employment_id} from {effective_date} with changes {amendment_data}.
POST /contract_amendments/automatable Submit an auto-approvable contract amendment · Submit An Automatable Contract Amendment #
Ask an LLM
“Can contract changes be approved automatically without Remote reviewing them by hand?”
“What is the structured amendment flow that skips manual review?”
Tell an agent
Submit an automatable contract amendment using the structured per-country payload.
File this salary change as an automatable amendment so it is approved without manual review.
GET /contract_amendments/{contract_amendment_id} View a contract amendment · Show A Contract Amendment #
Ask an LLM
“What is the status of a contract amendment I submitted?”
“How do I see the details of one contract amendment?”
Tell an agent
Show contract amendment {contract_amendment_id}.
Check the progress of amendment {contract_amendment_id}.
GET /contract_amendments/schema Get the amendment form for an employment · Show A Contract Amendment Schema #
Ask an LLM
“Which contract fields can be amended for an employee in their country?”
“Where is the JSON Schema for contract amendments per country?”
Tell an agent
Fetch the contract amendment schema for employment {employment_id}.
Show which amendment fields are allowed for employment {employment_id}.

Documentation

📖
Documentation
https://developer.remote.com/reference/welcome-to-remote-api
📖
Documentation
https://developer.remote.com/docs/creating-a-company
📖
Documentation
https://developer.remote.com/docs/create-new-employment
📖
Documentation
https://developer.remote.com/docs/employment-lifecycle-stages
📖
Documentation
https://developer.remote.com/docs/employment-statuses
📖
Documentation
https://developer.remote.com/docs/quick-start-guide-2
📖
Documentation
https://developer.remote.com/docs/working-with-expenses
📖
Documentation
https://developer.remote.com/docs/working-with-incentives
📖
Documentation
https://developer.remote.com/docs/working-with-time-off
📖
Documentation
https://developer.remote.com/docs/leave-policies-summary
📖
Documentation
https://developer.remote.com/docs/working-with-timesheets
📖
Documentation
https://developer.remote.com/docs/benefits-renewal
📖
Documentation
https://developer.remote.com/docs/working-with-files
📖
Documentation
https://developer.remote.com/docs/custom-fields
📖
Documentation
https://developer.remote.com/docs/working-with-countries
📖
Documentation
https://developer.remote.com/docs/employment-cost-estimation
📖
Documentation
https://developer.remote.com/docs/authentication
📖
Documentation
https://developer.remote.com/docs/authorization-for-customers
📖
Documentation
https://developer.remote.com/docs/client-credentials-flow-for-partners
📖
Documentation
https://developer.remote.com/docs/authorization-method-oauth-assertion
📖
Documentation
https://developer.remote.com/docs/refresh-token-flow

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/remote-com:remote-com-contract-amendments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

remote-com-contract-amendments-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Remote Employments Contract Amendments API
  description: 'Create and manage employment records across the EOR, Global Payroll, and

    PEO employment models on Remote.com. Endpoints cover the full employment

    lifecycle — onboarding, contract management, contract amendments,

    employment status transitions, identity verification, travel letters,

    work-authorization requests, and offboarding.


    Every Remote customer hiring through the platform owns one employment

    record per worker. This API is the authoritative source for that record.'
  version: '2026-05-22'
  contact:
    name: Remote API Support
    url: https://support.remote.com/
  x-logo:
    url: https://remote.com/favicon.ico
servers:
- url: https://gateway.remote.com/v1
  description: Production
- url: https://gateway.remote-sandbox.com/v1
  description: Sandbox
security:
- BearerAuth: []
tags:
- name: Contract Amendments
  description: Submit and track contract amendments
paths:
  /contract_amendments:
    get:
      summary: List Contract Amendments
      operationId: listContractAmendments
      tags:
      - Contract Amendments
      parameters:
      - name: employment_id
        in: query
        schema:
          type: string
          format: uuid
      - name: status
        in: query
        schema:
          type: string
          enum:
          - draft
          - submitted
          - review_started
          - done
          - canceled
          - deleted
      responses:
        '200':
          description: Contract amendments.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractAmendmentList'
    post:
      summary: Create A Contract Amendment
      operationId: createContractAmendment
      tags:
      - Contract Amendments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContractAmendmentCreateRequest'
      responses:
        '201':
          description: Created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractAmendmentEnvelope'
  /contract_amendments/automatable:
    post:
      summary: Submit An Automatable Contract Amendment
      description: 'Automatable amendments use a structured payload that Remote can

        approve without manual review. Use the `/contract_amendments/schema`

        endpoint to learn the per-country form requirements.'
      operationId: createAutomatableContractAmendment
      tags:
      - Contract Amendments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '201':
          description: Created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractAmendmentEnvelope'
  /contract_amendments/{contract_amendment_id}:
    parameters:
    - name: contract_amendment_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      summary: Show A Contract Amendment
      operationId: showContractAmendment
      tags:
      - Contract Amendments
      responses:
        '200':
          description: Amendment.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContractAmendmentEnvelope'
  /contract_amendments/schema:
    get:
      summary: Show A Contract Amendment Schema
      description: Returns the JSON Schema form definition for amendments in a given country and employment.
      operationId: showContractAmendmentSchema
      tags:
      - Contract Amendments
      parameters:
      - name: employment_id
        in: query
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: JSON Schema form.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
components:
  schemas:
    ContractAmendmentEnvelope:
      type: object
      properties:
        data:
          type: object
          properties:
            contract_amendment:
              $ref: '#/components/schemas/ContractAmendment'
    ContractAmendmentCreateRequest:
      type: object
      required:
      - employment_id
      - effective_date
      properties:
        employment_id:
          type: string
          format: uuid
        effective_date:
          type: string
          format: date
        amendment_data:
          type: object
          additionalProperties: true
    ContractAmendment:
      type: object
      properties:
        id:
          type: string
          format: uuid
        employment_id:
          type: string
          format: uuid
        status:
          type: string
          enum:
          - draft
          - submitted
          - review_started
          - done
          - canceled
          - deleted
        effective_date:
          type: string
          format: date
        amendment_data:
          type: object
          additionalProperties: true
        created_at:
          type: string
          format: date-time
    ContractAmendmentList:
      type: object
      properties:
        data:
          type: object
          properties:
            contract_amendments:
              type: array
              items:
                $ref: '#/components/schemas/ContractAmendment'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT