Update an Operation Route

curl --request PATCH \
  --url https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Pix Internal Account Credit",
  "code": "PIX-CREDIT",
  "description": "Pix Internal Account Credit",
  "account": {
    "ruleType": "account_type",
    "validIf": [
      "deposit"
    ],
    "metadata": {
      "customField1": "updatedValue",
      "customField2": 456,
      "newField": "newValue"
    }
  }
}
'

import requests

url = "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}"

payload = {
    "title": "Pix Internal Account Credit",
    "code": "PIX-CREDIT",
    "description": "Pix Internal Account Credit",
    "account": {
        "ruleType": "account_type",
        "validIf": ["deposit"],
        "metadata": {
            "customField1": "updatedValue",
            "customField2": 456,
            "newField": "newValue"
        }
    }
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Pix Internal Account Credit',
    code: 'PIX-CREDIT',
    description: 'Pix Internal Account Credit',
    account: {
      ruleType: 'account_type',
      validIf: ['deposit'],
      metadata: {customField1: 'updatedValue', customField2: 456, newField: 'newValue'}
    }
  })
};

fetch('https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Pix Internal Account Credit',
    'code' => 'PIX-CREDIT',
    'description' => 'Pix Internal Account Credit',
    'account' => [
        'ruleType' => 'account_type',
        'validIf' => [
                'deposit'
        ],
        'metadata' => [
                'customField1' => 'updatedValue',
                'customField2' => 456,
                'newField' => 'newValue'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}"

	payload := strings.NewReader("{\n  \"title\": \"Pix Internal Account Credit\",\n  \"code\": \"PIX-CREDIT\",\n  \"description\": \"Pix Internal Account Credit\",\n  \"account\": {\n    \"ruleType\": \"account_type\",\n    \"validIf\": [\n      \"deposit\"\n    ],\n    \"metadata\": {\n      \"customField1\": \"updatedValue\",\n      \"customField2\": 456,\n      \"newField\": \"newValue\"\n    }\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Pix Internal Account Credit\",\n  \"code\": \"PIX-CREDIT\",\n  \"description\": \"Pix Internal Account Credit\",\n  \"account\": {\n    \"ruleType\": \"account_type\",\n    \"validIf\": [\n      \"deposit\"\n    ],\n    \"metadata\": {\n      \"customField1\": \"updatedValue\",\n      \"customField2\": 456,\n      \"newField\": \"newValue\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Pix Internal Account Credit\",\n  \"code\": \"PIX-CREDIT\",\n  \"description\": \"Pix Internal Account Credit\",\n  \"account\": {\n    \"ruleType\": \"account_type\",\n    \"validIf\": [\n      \"deposit\"\n    ],\n    \"metadata\": {\n      \"customField1\": \"updatedValue\",\n      \"customField2\": 456,\n      \"newField\": \"newValue\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "organizationId": "019c96a0-0a98-7287-9a31-786e0809c769",
  "ledgerId": "019c96a0-0ac0-7de9-9f53-9cf842a2ee5a",
  "account": {
    "ruleType": "account_type",
    "validIf": [
      "deposit"
    ]
  },
  "code": "PIX-CREDIT",
  "description": "Pix Internal Account Credit",
  "operationType": "destination",
  "title": "Pix Internal Account Credit",
  "metadata": {
    "customField1": "updatedValue",
    "customField2": 456
  },
  "createdAt": "2026-02-25T21:06:38.348683Z",
  "deletedAt": null,
  "updatedAt": "2026-02-25T21:06:38.348683Z"
}

PATCH

organizations

{organization_id}

ledgers

{ledger_id}

operation-routes

{operation_route_id}

Update an Operation Route

curl --request PATCH \
  --url https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Pix Internal Account Credit",
  "code": "PIX-CREDIT",
  "description": "Pix Internal Account Credit",
  "account": {
    "ruleType": "account_type",
    "validIf": [
      "deposit"
    ],
    "metadata": {
      "customField1": "updatedValue",
      "customField2": 456,
      "newField": "newValue"
    }
  }
}
'

import requests

url = "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}"

payload = {
    "title": "Pix Internal Account Credit",
    "code": "PIX-CREDIT",
    "description": "Pix Internal Account Credit",
    "account": {
        "ruleType": "account_type",
        "validIf": ["deposit"],
        "metadata": {
            "customField1": "updatedValue",
            "customField2": 456,
            "newField": "newValue"
        }
    }
}
headers = {"Content-Type": "application/json"}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Pix Internal Account Credit',
    code: 'PIX-CREDIT',
    description: 'Pix Internal Account Credit',
    account: {
      ruleType: 'account_type',
      validIf: ['deposit'],
      metadata: {customField1: 'updatedValue', customField2: 456, newField: 'newValue'}
    }
  })
};

fetch('https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Pix Internal Account Credit',
    'code' => 'PIX-CREDIT',
    'description' => 'Pix Internal Account Credit',
    'account' => [
        'ruleType' => 'account_type',
        'validIf' => [
                'deposit'
        ],
        'metadata' => [
                'customField1' => 'updatedValue',
                'customField2' => 456,
                'newField' => 'newValue'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}"

	payload := strings.NewReader("{\n  \"title\": \"Pix Internal Account Credit\",\n  \"code\": \"PIX-CREDIT\",\n  \"description\": \"Pix Internal Account Credit\",\n  \"account\": {\n    \"ruleType\": \"account_type\",\n    \"validIf\": [\n      \"deposit\"\n    ],\n    \"metadata\": {\n      \"customField1\": \"updatedValue\",\n      \"customField2\": 456,\n      \"newField\": \"newValue\"\n    }\n  }\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}")
  .header("Content-Type", "application/json")
  .body("{\n  \"title\": \"Pix Internal Account Credit\",\n  \"code\": \"PIX-CREDIT\",\n  \"description\": \"Pix Internal Account Credit\",\n  \"account\": {\n    \"ruleType\": \"account_type\",\n    \"validIf\": [\n      \"deposit\"\n    ],\n    \"metadata\": {\n      \"customField1\": \"updatedValue\",\n      \"customField2\": 456,\n      \"newField\": \"newValue\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/ledgers/{ledger_id}/operation-routes/{operation_route_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"title\": \"Pix Internal Account Credit\",\n  \"code\": \"PIX-CREDIT\",\n  \"description\": \"Pix Internal Account Credit\",\n  \"account\": {\n    \"ruleType\": \"account_type\",\n    \"validIf\": [\n      \"deposit\"\n    ],\n    \"metadata\": {\n      \"customField1\": \"updatedValue\",\n      \"customField2\": 456,\n      \"newField\": \"newValue\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "organizationId": "019c96a0-0a98-7287-9a31-786e0809c769",
  "ledgerId": "019c96a0-0ac0-7de9-9f53-9cf842a2ee5a",
  "account": {
    "ruleType": "account_type",
    "validIf": [
      "deposit"
    ]
  },
  "code": "PIX-CREDIT",
  "description": "Pix Internal Account Credit",
  "operationType": "destination",
  "title": "Pix Internal Account Credit",
  "metadata": {
    "customField1": "updatedValue",
    "customField2": 456
  },
  "createdAt": "2026-02-25T21:06:38.348683Z",
  "deletedAt": null,
  "updatedAt": "2026-02-25T21:06:38.348683Z"
}

Path Parameters

organization_id

string<uuid>

required

The unique identifier of the Organization associated with the Ledger.

ledger_id

string<uuid>

required

The unique identifier of the associated Ledger.

operation_route_id

string<uuid>

required

The unique identifier of the Operation Route that you want to retrieve.

Body

application/json

title

string

Short text summarizing the purpose of the operation. Used as an entry note for identification.

Maximum string length: 255

description

string

Detailed description of the Operation Route purpose and usage.

Maximum string length: 250

code

string

deprecated

An external reference used to identify the operation route. Deprecated: use rubric codes inside accountingEntries instead.

Maximum string length: 100

account

object

Defines the rule for selecting the account that will participate in the operation (debit or credit).

Show child attributes

metadata

object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

Constraints: keys must be at most 100 characters; string values at most 2000 characters. Nested objects are not allowed (values must be string, number, or boolean), the structure may not exceed a maximum depth of 10, and a maximum of 100 keys is permitted.

Show child attributes

accountingEntries

object

Accounting entries grouped by transaction action type. Each action maps to a pair of debit and credit rubrics.

Show child attributes

Response

Indicates that the resource was successfully created and the operation was completed as expected.

string<uuid>

The unique identifier of the Operation Route.

organizationId

string<uuid>

The unique identifier of the Organization.

ledgerId

string<uuid>

The unique identifier of the Ledger.

title

string

Short text summarizing the purpose of the operation. Used as an entry note for identification.

code

string

deprecated

An external reference used to identify the operation route. Deprecated: use rubric codes inside accountingEntries instead.

Maximum string length: 100

description

string

Detailed description of the Operation Route purpose and usage.

operationType

enum<string>

The type of the Operation Route. Use bidirectional when the route can operate in both directions.

Available options:

source,

destination,

bidirectional

accountingEntries

object

Accounting entries grouped by transaction action type. Each action maps to a pair of debit and credit rubrics.

Show child attributes

account

object

Defines the rule for selecting the account that will participate in the operation (debit or credit).

Show child attributes

createdAt

string<date-time>

Timestamp of creation (UTC).

updatedAt

string<date-time>

Timestamp of last update (UTC).

deletedAt

string<date-time> | null

Timestamp of soft deletion, if applicable (UTC).

metadata

object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

Show child attributes

Retrieve an Operation Route

Delete an Operation Route

Getting started

Organizations API

Ledgers API

Assets API

Account Types API

Accounts API

Portfolios API

Segments API

Balances API

Transactions API

Operations API

Operation Routes API

Transaction Routes API

Metadata Indexes API

Holders API

Instruments API

Billing Packages API

Packages API

Billing Calculation API

Estimation API

Encryption API

Protection API

Asset Rates API

Error handling

Fees Engine

Update an Operation Route

Path Parameters

Body

Response