Skip to main content
PUT
/
identities
/
{identity_id}
Edit identity
curl --request PUT \
  --url http://localhost:5001/identities/{identity_id} \
  --header 'X-blnk-key: <api-key>'
import requests

url = "http://localhost:5001/identities/{identity_id}"

headers = {"X-blnk-key": "<api-key>"}

response = requests.put(url, headers=headers)

print(response.text)
const options = {method: 'PUT', headers: {'X-blnk-key': '<api-key>'}};

fetch('http://localhost:5001/identities/{identity_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_PORT => "5001",
  CURLOPT_URL => "http://localhost:5001/identities/{identity_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "X-blnk-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

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

func main() {

	url := "http://localhost:5001/identities/{identity_id}"

	req, _ := http.NewRequest("PUT", url, nil)

	req.Header.Add("X-blnk-key", "<api-key>")

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

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

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.put("http://localhost:5001/identities/{identity_id}")
  .header("X-blnk-key", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

url = URI("http://localhost:5001/identities/{identity_id}")

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

request = Net::HTTP::Put.new(url)
request["X-blnk-key"] = '<api-key>'

response = http.request(request)
puts response.read_body
Use blnk.identity.update to change the profile details on an identity.
1

Call the method

blnk.identity.update
response = blnk.identity.update(
  "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
  {
    "identity_type": "individual",
    "first_name": "Jane",
    "last_name": "Smith",
  },
)
FieldTypeDescription
idstrIdentity ID to update.
identity_typestrindividual or organization.
Profile fieldsstringAny field from create you want to change.
2

Verify the changes

Read response.data to confirm the updated profile fields. The identity ID stays the same.
3

Response

200 OK
{
  "identity_id": "idt_3b63c8da-af29-4cc3-ad38-df17d87456e6",
  "identity_type": "individual",
  "first_name": "Jane",
  "last_name": "Smith",
  "email_address": "alice.smith@example.com",
  "created_at": "2024-11-26T08:36:36.238244338Z"
}
FieldTypeDescription
identity_idstrUnique ID for the identity.
created_atstrDate and time the identity was created.
The response returns the full identity with your changes applied.

How identities work

Linking balances and handling profile data.

Edit identity

HTTP request and response schema.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.