---
title: "Reverse this allocation and create negative reconciliation lines to free up the amount that was allocated"
method: PUT
path: "/payables/allocations/{id}/reverse"
tags: ["Payables-Allocation"]
---

# Reverse this allocation and create negative reconciliation lines to free up the amount that was allocated

`PUT /payables/allocations/{id}/reverse`

## Request

- Base URL: `https://r38.coupadev.com/api`
- URL: `https://r38.coupadev.com/api/payables/allocations/{id}/reverse`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://r38.coupadev.com/oauth2/authorizations/new`
    - Token URL: `https://r38.coupadev.com/oauth2/token`
  - OAuth 2
    - Client credentials
    - Token URL: `https://r38.coupadev.com/oauth2/access_tokens`
- TypeScript: <https://skmtc.dev/coupa/apis/coupa-api-4/docs/payables/allocations/:id/reverse/put.ts> (a function with typed inputs; its response is checked against the schema)

Reverse this allocation and create negative reconciliation lines to free up the amount that was allocated

## Path parameters

- `id` integer, required

## Query parameters

- `return_object` 'limited' | 'shallow' | 'none'
- `filter` string

## Request body

- PayablesAllocation
  - `bypass-strict-validations` boolean: Flag indicating that this allocation is confirmed to be correct. Skips overallocation validations
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `created-by` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `exported?` boolean: Flag indicating whether the transaction has been exported to an external system
  - `id` integer: Coupa unique identifier
  - `last-exported-at` string, datetime: Date of last update to the allocation
  - `payable-from-amount` number, required: Amount allocated in currency of the document sending the allocation
  - `payable-from-currency` Currency, required
    - `code` string, string(6), required: code
    - `decimals` integer: Decimal precision
    - `enabled` boolean: Enabled
    - `id` integer: Coupa unique identifier
    - `name` string, string(100), required: name
    - `symbol` string, string(10): symbol
  - `payable-from-id` integer: Coupa ID of the payable document sending the allocation
  - `payable-from-type` string, string(255): Type of payable document sending the allocation
  - `payable-to-amount` number, required: Amount allocated in currency of the document receiving the allocation
  - `payable-to-currency` Currency, required
    - `code` string, string(6), required: code
    - `decimals` integer: Decimal precision
    - `enabled` boolean: Enabled
    - `id` integer: Coupa unique identifier
    - `name` string, string(100), required: name
    - `symbol` string, string(10): symbol
  - `payable-to-id` integer: Coupa ID of the payable document receiving the allocation
  - `payable-to-type` string, string(255): Type of payable document receiving the allocation
  - `payment-reference-id` integer: Coupa ID of payment reference
  - `payment-reference-type` string, string(255): Type of payment reference
  - `reason-code` 'payment' | 'auto_payment' | 'epr' | 'epr_rejected' | 'manual', string(40): Code indicating the trigger for this allocation
  - `source` 'coupa_pay' | 'erp' | 'ui' | 'api' | 'csv' | 'early_pay_discount', string(255): Originating system (ERP, Coupa Pay, UI, etc)
  - `source-transaction-from-id` string, string: Coupa ID of the source transaction on the sending side
  - `source-transaction-from-reference` string, string: Reference number of the source transaction on the sending side
  - `source-transaction-from-type` string, string: Type of the source transaction on the sending side
  - `source-transaction-to-id` string, string: Coupa ID of the source transaction on the receiving side
  - `source-transaction-to-reference` string, string: Reference number of the source transaction on the receiving side
  - `source-transaction-to-type` string, string: Type of the source transaction on the receiving side
  - `status` string, string(255): Current status of the allocation
  - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `updated-by` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ

## Response `200`

Payables-Allocation object

- PayablesAllocation[]
  - `bypass-strict-validations` boolean: Flag indicating that this allocation is confirmed to be correct. Skips overallocation validations
  - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `created-by` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `exported?` boolean: Flag indicating whether the transaction has been exported to an external system
  - `id` integer: Coupa unique identifier
  - `last-exported-at` string, datetime: Date of last update to the allocation
  - `payable-from-amount` number, required: Amount allocated in currency of the document sending the allocation
  - `payable-from-currency` Currency, required
    - `code` string, string(6), required: code
    - `decimals` integer: Decimal precision
    - `enabled` boolean: Enabled
    - `id` integer: Coupa unique identifier
    - `name` string, string(100), required: name
    - `symbol` string, string(10): symbol
  - `payable-from-id` integer: Coupa ID of the payable document sending the allocation
  - `payable-from-type` string, string(255): Type of payable document sending the allocation
  - `payable-to-amount` number, required: Amount allocated in currency of the document receiving the allocation
  - `payable-to-currency` Currency, required
    - `code` string, string(6), required: code
    - `decimals` integer: Decimal precision
    - `enabled` boolean: Enabled
    - `id` integer: Coupa unique identifier
    - `name` string, string(100), required: name
    - `symbol` string, string(10): symbol
  - `payable-to-id` integer: Coupa ID of the payable document receiving the allocation
  - `payable-to-type` string, string(255): Type of payable document receiving the allocation
  - `payment-reference-id` integer: Coupa ID of payment reference
  - `payment-reference-type` string, string(255): Type of payment reference
  - `reason-code` 'payment' | 'auto_payment' | 'epr' | 'epr_rejected' | 'manual', string(40): Code indicating the trigger for this allocation
  - `source` 'coupa_pay' | 'erp' | 'ui' | 'api' | 'csv' | 'early_pay_discount', string(255): Originating system (ERP, Coupa Pay, UI, etc)
  - `source-transaction-from-id` string, string: Coupa ID of the source transaction on the sending side
  - `source-transaction-from-reference` string, string: Reference number of the source transaction on the sending side
  - `source-transaction-from-type` string, string: Type of the source transaction on the sending side
  - `source-transaction-to-id` string, string: Coupa ID of the source transaction on the receiving side
  - `source-transaction-to-reference` string, string: Reference number of the source transaction on the receiving side
  - `source-transaction-to-type` string, string: Type of the source transaction on the receiving side
  - `status` string, string(255): Current status of the allocation
  - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
  - `updated-by` UserSimple
    - `avatar-thumb-url` string, string: Avatar url
    - `created-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ
    - `email` string, string(255), required: email
    - `employee-number` string, string(255): employee number
    - `firstname` string, string(40), required: first name
    - `fullname` string, string(255): full name
    - `id` integer: Coupa unique identifier
    - `lastname` string, string(40), required: last name
    - `login` string, string(255), required: login
    - `salesforce-id` string, string(255), required: salesforce_id
    - `updated-at` string, datetime: Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/coupa/apis/coupa-api-4.md) - [All operations](https://skmtc.dev/coupa/apis/coupa-api-4/llms.txt) - [OpenAPI document](https://skmtc.dev/coupa/apis/coupa-api-4/revisions/adc09cabd758?raw)