---
title: "Validate resignation request"
method: PUT
path: "/v1/resignations/{offboarding_request_id}/validate"
tags: ["Resignations"]
---

# Validate resignation request

`PUT /v1/resignations/{offboarding_request_id}/validate`

## Request

- Base URL: `https://gateway.remote.com`
- URL: `https://gateway.remote.com/v1/resignations/{offboarding_request_id}/validate`
- Auth: one of:
  - OAuth 2
    - Authorization code: `/auth/oauth2/authorize`
    - Token URL: `/auth/oauth2/token` scopes: `https://gateway.remote.com/company.manage`
  - OAuth 2
    - Authorization code: `/auth/oauth2/authorize`
    - Token URL: `/auth/oauth2/token` scopes: `resignation:write`
  - OAuth 2
    - Authorization code: `/auth/oauth2/authorize`
    - Token URL: `/auth/oauth2/token` scopes: `all:write`
  - OAuth 2
    - Client credentials
    - Token URL: `/auth/oauth2/token` scopes: `resignation:write`
  - OAuth 2
    - Client credentials
    - Token URL: `/auth/oauth2/token` scopes: `all:write`
  - HTTP bearer

Validates a resignation employment request

## Authentication

This endpoint accepts any one of the following token types:

- **Company-scoped access token** (`OAuth2AuthorizationCode`) — obtained by a company manager through the Authorization Code flow or the Refresh Token flow. See [Authentication for partners](https://developer.remote.com/docs/authentication-for-partners).
- **Company-scoped access token (assertion)** (`OAuth2CompanyManagerAssertion`) — obtained through the `urn:ietf:params:oauth:grant-type:jwt-bearer` grant for a company manager. See [OAuth Assertion](https://developer.remote.com/docs/authorization-method-oauth-assertion).
- **Customer API token** (`CustomerAPIToken`) — generated by the customer on their Integration Settings page, with the scopes they choose there. See [Authorization for customers](https://developer.remote.com/docs/authorization-for-customers).

## Scopes

Any one of the scopes in a token type's row is enough. `all:write` works too.

| Token type | Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|---|
| Company-scoped access token | Manage employments (`employments`) | - | Manage resignations (`resignation:write`) |
| Company-scoped access token (assertion) | Manage employments (`employments`) | - | Manage resignations (`resignation:write`) |
| Customer API token | Manage employments (`employments`) | - | Manage resignations (`resignation:write`) |

## Path parameters

- `offboarding_request_id` string, required

## Request body

- union
  - object
    - `accepts_proposed_notice` boolean, required: Whether the employer accepts the proposed notice period and last working day. If false, provide an alternative `proposed_last_date`.
    - `agrees_to_pto_amount` boolean, required: Whether the employer agrees with the employee's current PTO balance. If false, provide notes explaining the discrepancy.
    - `agrees_to_pto_amount_notes` string: Required if `agrees_to_pto_amount` is set to false.
    - `agrees_to_resignation_reason` boolean, required: Whether the employer agrees with the resignation reason stated by the employee. If false, provide notes with the employer's perspective.
    - `agrees_to_resignation_reason_notes` string: required if `agrees_to_resignation_reason` is set to false.
    - `has_additional_information` boolean, required: Whether the employer has additional information to share about the resignation. If true, provide notes.
    - `has_additional_information_notes` string: required if `has_additional_information` is set to true.
    - `has_more_salary_info` boolean, required: Whether there are salary adjustments or additional salary information to communicate. If true, provide notes.
    - `has_more_salary_info_notes` string: required if `has_more_salary_info` is set to true.
    - `is_owed_outstanding_reimbursements` boolean, required: Whether the employee is owed any outstanding expense reimbursements. If true, provide the amount and notes.
    - `owed_outstanding_reimbursements` object: required if `is_owed_outstanding_reimbursements` is set to true.
      - `amount` integer: The amount (in the currency of the employment) to be given to the employee. This field accepts fractional amounts as well. However to avoid precision issues and errors that can arise from storing fractional amounts, the Remote API only accepts currencies and their fractional amounts as integers. This means you should append fractional amounts to the end of the amount you're passing in with this field. For example, if the amount you're offering is EUR 500.25, you would specify `50025` as the amount for this field.
      - `notes` string
    - `proposed_last_date` object: Required if `accepts_proposed_notice` is set to false.
      - `date` string, date
      - `notes` string
    - `timesheet_file` ResignationFile
      - `content` string, binary, required: The content in base64 encoding
      - `name` string, required: The file name
    - `will_take_more_pto` boolean, required: Whether the employee intends to take more PTO before their last working day. If true, provide notes with details.
    - `will_take_more_pto_notes` string: required if `will_take_more_pto` is set to true.
  - object
    - `proposed_resignation_accepted` boolean, required: Whether the employer accepts the employee's resignation. If false, notes are required explaining why.
    - `proposed_resignation_accepted_notes` string: Required if `proposed_resignation_accepted` is set to false.

## 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

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `429`: Unprocessable Entity

---

[API](https://skmtc.dev/remote-com/apis/offboarding.md) - [All operations](https://skmtc.dev/remote-com/apis/offboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/remote-com/apis/offboarding/revisions/f0d3f7cbc9dd?raw)