Skip to main content
Patch User Beneficiary
curl --request PATCH \
  --url https://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json-patch+json' \
  --data '
[
  {
    "op": "replace",
    "path": "/name",
    "value": "John Doe"
  }
]
'
import requests

url = "https://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}"

payload = [
    {
        "op": "replace",
        "path": "/name",
        "value": "John Doe"
    }
]
headers = {
    "Authorization": "Basic <encoded-value>",
    "Content-Type": "application/json-patch+json"
}

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

print(response.text)
const options = {
  method: 'PATCH',
  headers: {
    Authorization: 'Basic <encoded-value>',
    'Content-Type': 'application/json-patch+json'
  },
  body: JSON.stringify([{op: 'replace', path: '/name', value: 'John Doe'}])
};

fetch('https://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}', 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://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}",
  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([
    [
        'op' => 'replace',
        'path' => '/name',
        'value' => 'John Doe'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>",
    "Content-Type: application/json-patch+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://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}"

	payload := strings.NewReader("[\n  {\n    \"op\": \"replace\",\n    \"path\": \"/name\",\n    \"value\": \"John Doe\"\n  }\n]")

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

	req.Header.Add("Authorization", "Basic <encoded-value>")
	req.Header.Add("Content-Type", "application/json-patch+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://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}")
  .header("Authorization", "Basic <encoded-value>")
  .header("Content-Type", "application/json-patch+json")
  .body("[\n  {\n    \"op\": \"replace\",\n    \"path\": \"/name\",\n    \"value\": \"John Doe\"\n  }\n]")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.yapily.com/users/{userId}/beneficiaries/{beneficiaryId}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Basic <encoded-value>'
request["Content-Type"] = 'application/json-patch+json'
request.body = "[\n  {\n    \"op\": \"replace\",\n    \"path\": \"/name\",\n    \"value\": \"John Doe\"\n  }\n]"

response = http.request(request)
puts response.read_body
{
  "meta": {
    "tracingId": "<string>"
  },
  "data": {
    "beneficiaryId": "e7b7636d-a041-4013-8a1b-34dc85b7d341",
    "details": {
      "name": "John Doe",
      "accountIdentifier": {
        "type": "IBAN",
        "identification": "DE12345123451234512345123"
      },
      "match": {
        "closeMatchName": "John Doe"
      }
    }
  }
}
{
  "error": {
    "tracingId": "0c2d0973bdd24224a65e5d0f7d1b6154",
    "code": 400,
    "status": "BAD_REQUEST",
    "supportUrl": "https://support.yapily.com/",
    "source": "YAPILY",
    "issues": [
      {
        "type": "BAD_REQUEST",
        "code": 10600,
        "message": "The server could not understand the request due to invalid syntax"
      }
    ]
  }
}
{
  "error": {
    "tracingId": "0c2d0973bdd24224a65e5d0f7d1b6154",
    "code": 400,
    "status": "BAD_REQUEST",
    "supportUrl": "https://support.yapily.com/",
    "source": "YAPILY",
    "issues": [
      {
        "type": "BAD_REQUEST",
        "code": 10600,
        "message": "The server could not understand the request due to invalid syntax"
      }
    ]
  }
}
{
  "error": {
    "tracingId": "0c2d0973bdd24224a65e5d0f7d1b6154",
    "code": 400,
    "status": "BAD_REQUEST",
    "supportUrl": "https://support.yapily.com/",
    "source": "YAPILY",
    "issues": [
      {
        "type": "BAD_REQUEST",
        "code": 10600,
        "message": "The server could not understand the request due to invalid syntax"
      }
    ]
  }
}
{
  "error": {
    "tracingId": "0c2d0973bdd24224a65e5d0f7d1b6154",
    "code": 400,
    "status": "BAD_REQUEST",
    "supportUrl": "https://support.yapily.com/",
    "source": "YAPILY",
    "issues": [
      {
        "type": "BAD_REQUEST",
        "code": 10600,
        "message": "The server could not understand the request due to invalid syntax"
      }
    ]
  }
}
{
  "error": {
    "tracingId": "0c2d0973bdd24224a65e5d0f7d1b6154",
    "code": 400,
    "status": "BAD_REQUEST",
    "supportUrl": "https://support.yapily.com/",
    "source": "YAPILY",
    "issues": [
      {
        "type": "BAD_REQUEST",
        "code": 10600,
        "message": "The server could not understand the request due to invalid syntax"
      }
    ]
  }
}
{
  "error": {
    "tracingId": "0c2d0973bdd24224a65e5d0f7d1b6154",
    "code": 400,
    "status": "BAD_REQUEST",
    "supportUrl": "https://support.yapily.com/",
    "source": "YAPILY",
    "issues": [
      {
        "type": "BAD_REQUEST",
        "code": 10600,
        "message": "The server could not understand the request due to invalid syntax"
      }
    ]
  }
}

Authorizations

Authorization
string
header
required

Use HTTP Basic Authentication with your Application ID as username and Application Secret as password. Manage credentials in the Yapily Console. See Authentication for details.

Headers

sub-application
string<uuid>

The sub-application ID to which event type is being subscribed to

Path Parameters

beneficiaryId
string<uuid>
required

Beneficiary Id

Example:

"e7b7636d-a041-4013-8a1b-34dc85b7d341"

userId
string<uuid>
required
Example:

"e7b7636d-a041-4013-8a1b-34dc85b7d341"

Body

application/json-patch+json

The JSON Patch instructions to patch the beneficiary

op
enum<string>
required

The operation to be performed

Available options:
add,
replace
path
string
required

The path to the target location

value
string
required

The value to be added, replaced or tested

Response

OK

The user beneficiary response.

meta
object
data
object

Beneficiary data response.