Create an operation relation
An explicit refund/reversal/correction/replacement relation (§11: an opposite payment is NOT automatically treated as a refund). Both operations must be in this Vault and accessible to the initiator. Self-reference is forbidden. relatedAmountRaw (partial refund) requires tokenId and is validated against the operation's token. Relations are never physically deleted.
curl -X POST "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-relations" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-d '{
"sourceOperationType": "deposit",
"sourceOperationId": "example_string",
"targetOperationType": "deposit",
"targetOperationId": "example_string",
"relationType": "refund",
"relatedAmountRaw": "example_string",
"tokenId": "example_string",
"comment": "example_string"
}'
import requests
import json
url = "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-relations"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
data = {
"sourceOperationType": "deposit",
"sourceOperationId": "example_string",
"targetOperationType": "deposit",
"targetOperationId": "example_string",
"relationType": "refund",
"relatedAmountRaw": "example_string",
"tokenId": "example_string",
"comment": "example_string"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-relations", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
},
body: JSON.stringify({
"sourceOperationType": "deposit",
"sourceOperationId": "example_string",
"targetOperationType": "deposit",
"targetOperationId": "example_string",
"relationType": "refund",
"relatedAmountRaw": "example_string",
"tokenId": "example_string",
"comment": "example_string"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"sourceOperationType": "deposit",
"sourceOperationId": "example_string",
"targetOperationType": "deposit",
"targetOperationId": "example_string",
"relationType": "refund",
"relatedAmountRaw": "example_string",
"tokenId": "example_string",
"comment": "example_string"
}`)
req, err := http.NewRequest("POST", "https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-relations", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://policy-engine-rest.ezig.workers.dev/api/v1/vaults/demo_vault/operation-relations')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
request.body = '{
"sourceOperationType": "deposit",
"sourceOperationId": "example_string",
"targetOperationType": "deposit",
"targetOperationId": "example_string",
"relationType": "refund",
"relatedAmountRaw": "example_string",
"tokenId": "example_string",
"comment": "example_string"
}'
response = http.request(request)
puts response.body
{
"id": "cmr3f41z20001psp7phmyapw3",
"vaultId": "example_string",
"sourceOperationType": "deposit",
"sourceOperationId": "example_string",
"targetOperationType": "deposit",
"targetOperationId": "example_string",
"relationType": "refund",
"relatedAmountRaw": "example_string",
"tokenId": "example_string",
"comment": "example_string",
"createdById": "example_string",
"createdAt": "2026-07-02T11:25:15.134000Z"
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
{
"error": "Not Found",
"message": "The requested resource was not found",
"code": 404
}
{
"error": "Unprocessable Entity",
"message": "The request was well-formed but contains semantic errors",
"code": 422,
"details": [
{
"field": "password",
"message": "Password must be at least 8 characters long"
}
]
}
{
"error": "Internal Server Error",
"message": "An unexpected error occurred on the server",
"code": 500,
"requestId": "req_1234567890"
}
/api/v1/vaults/{code}/operation-relationsTarget server for requests. Edit to use your own host.
Session token. Mobile/services. The web uses a cookie.
API key (sent in cookie)
Unique Vault code (slug)
The media type of the request body
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. Session token. Mobile/services. The web uses a cookie.
API Key for authentication. Provide your API key in the cookie.
Path Parameters
Body
deposittransferdeposittransferrefundreversalcorrectionreplacement