This API allows you to update the request to one of the following statuses:

APPROVED – Approves the request.
REJECTED – Rejects the request.
CUSTOM – Sets a custom intermediate status.
Note: The CUSTOM status is not supported for Customer Merge requests.

❗️
You cannot approve a request that is REJECTED. To approve a rejected request, first change its status to PENDING, and then change it to APPROVED.

Transaction Request

This API is to update the transaction request only. To update regular transactions, see the Update regular transaction API.

Customer Merge Request

Customer Merge requests can be modified in standard organizations, organizations with dual eligibility enabled, and connected organizations.
In a connected organization setup, only the parent organization can modify the status of a request. Any request initiated from a child organization is blocked.

API Endpoint

<https://{host}/v2/requests>

Prerequisites

Authentication - Basic or OAuth authentication
Access group resource - Write permission on Requests resource group

Resource information


URI	v2/requests
HTTP method	PUT
Pagination supported?	NA
Batch support	NA

Request Body Parameters

Parameter	Data Type	Description
type*	Enum	The type of request. Values: `TRANSACTION` - For transaction request, `CHANGE_IDENTIFIER` - For customer merge request.
baseType*	Enum	The base type of the request. Values: `REGULAR_TXN_ADD` - For transaction request, `MERGE` - For customer merge request.
id*	Long	The unique identifier of the request, generated during the POST call to add the request.
status*	Enum	The status to which the request should be changed. Values: `APPROVED`, `REJECTED`, `CUSTOM`.
comments	String	Additional comments or notes related to the request. Example: `Working`.

 '[
  {
    "type": "TRANSACTION",
    "baseType": "REGULAR_TXN_ADD",
    "id": 1031558,
    "status": "APPROVED",
    "comments": "Test"
  }
]'

	curl --location --request PUT 'https://eu.api.capillarytech.com/v2/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ZGlTdlYTI0YTYyZTZm' \
--header 'Cookie: _cfuvid=EWw7Wfz8Ouj54ZVF2cPldbObmSaOCCsfBD._qxSWZoM-1744468652196-0.0.1.1-604800000' \
--data '[{
    "type": "CHANGE_IDENTIFIER",
    "baseType": "MERGE",
    "status": "APPROVED", 
    "id": 13030101
}]'

	curl --location --request PUT 'https://eu.api.capillarytech.com/v2/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ZGlTdlYTI0YTYyZTZm' \
--header 'Cookie: _cfuvid=EWw7Wfz8Ouj54ZVF2cPldbObmSaOCCsfBD._qxSWZoM-1744468652196-0.0.1.1-604800000' \
--data '[{
    "type": "CHANGE_IDENTIFIER",
    "baseType": "MERGE",
    "status": "APPROVED", 
    "id": 13029191
}]'

	curl --location --request PUT 'https://eu.api.capillarytech.com/v2/requests' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic ZGlTdlYTI0YTYyZTZm' \
--header 'Cookie: _cfuvid=EWw7Wfz8Ouj54ZVF2cPldbObmSaOCCsfBD._qxSWZoM-1744468652196-0.0.1.1-604800000' \
--data '[{
    "type": "CHANGE_IDENTIFIER",
    "baseType": "MERGE",
    "status": "APPROVED", 
    "id": 13029723
}]'

Response parameters

Parameter	Data Type	Description
response	Array	List of responses for each request processed.
-entityId	Long	Unique identifier of the request.
-warnings	Array	List of warnings encountered for the request, if any.
-errors	Array	List of errors encountered for the request, if any.
-- status	Boolean	Indicates whether the API call was successful or not. Success- `True`Failure - `False`
-- code	Integer	Error code explaining the reason for failure.
-- message	String	Error message describing the issue.
totalCount	Integer	Total number of requests that were processed.
failureCount	Integer	Number of requests that failed during processing.

{
    "response": [
        {
            "entityId": 1031558,
            "result": true,
            "warnings": []
        }
    ],
    "totalCount": 1,
    "failureCount": 0
}

{
    "response": [
        {
            "entityId": 13030101,
            "result": true,
            "warnings": []
        }
    ],
    "totalCount": 1,
    "failureCount": 0
}

{
    "response": [
        {
            "entityId": 13029191,
            "result": true,
            "warnings": []
        }
    ],
    "totalCount": 1,
    "failureCount": 0
}

{
    "response": [
        {
            "entityId": 13029723,
            "errors": [
                {
                    "status": false,
                    "code": 9021,
                    "message": "Request Add/Update is blocked for the org"
                }
            ]
        }
    ],
    "totalCount": 1,
    "failureCount": 1
}

Error Codes

Error Codes	Description	Reason
9050	Request not found	Incorrect request ID
9021	Request Add/Update is blocked for the org	Request originates from the child organization.