Edit Identity

PUT

identities

{identity_id}

curl -X PUT "http://localhost:5001/identities/{identity_id}" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_type": "individual",
    "organization_name": "",
    "first_name": "Alice",
    "last_name": "Smith",
    "other_names": "Marie",
    "gender": "female",
    "dob": "1985-05-15T00:00:00Z",
    "email_address": "alice.smith@example.com",
    "phone_number": "+1234567890",
    "nationality": "Canadian",
    "category": "customer",
    "street": "789 Elm St",
    "country": "Canada",
    "state": "Ontario",
    "post_code": "M4B 1B3",
    "city": "Toronto",
    "meta_data": {
      "customer_id": "CUST123456",
      "membership_level": "Gold",
      "preferred_language": "English",
      "verification_data": {
          "verified_by": "ThirdPartyService",
          "verification_date": "2024-07-01T10:00:00Z",
          "verification_status": "verified"
      }
    }
  }'

{
  "error": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found",
  "error_detail": {
    "code": "IDT_NOT_FOUND",
    "message": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found"
  }
}

If you’re using the auto-provisioned Enterprise Core instance included with your Production License deployment, set the base URL to: https://ENTERPRISE_PUBLIC_URL/core.If you’re connecting to a different Core instance, use the publicly accessible base URL for that instance instead.

Authorization

If set, the API uses an API key for authentication. Include the following header in your requests: X-blnk-key: <api-key>. Replace <api-key> with your secret API key. Ensure the key is kept secure and not exposed in public repositories or client-side code. See also: Scoped API keys and Secure your Blnk server.

Path

string

required

Specifies the unique ID of the identity that needs to be updated.

Body

string

required

Specifies the identity type. Options are "individual" or "organization"

string

Name of the organization.

string

First name of individual.

string

Last name of individual.

string

Any other names linked to individual.

string

Gender of the individual.

string

Date of birth.

string

Email address of the identity.

string

Contact number of the identity.

string

Nationality of the individual.

string

Type of customer depending on your use case.

string

Street address of the identity.

string

Residential country of the identity.

string

State of residence of the identity.

string

Postal code related to the identity.

string

City of residence of the identity.

string

Custom metadata linked to the identity.

Response

All parameters from the request body also mean the same in the corresponding response JSON.

string

required

Unique id of the created identity.

string

Specified the date and time the identity was created.

curl -X PUT "http://localhost:5001/identities/{identity_id}" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_type": "individual",
    "organization_name": "",
    "first_name": "Alice",
    "last_name": "Smith",
    "other_names": "Marie",
    "gender": "female",
    "dob": "1985-05-15T00:00:00Z",
    "email_address": "alice.smith@example.com",
    "phone_number": "+1234567890",
    "nationality": "Canadian",
    "category": "customer",
    "street": "789 Elm St",
    "country": "Canada",
    "state": "Ontario",
    "post_code": "M4B 1B3",
    "city": "Toronto",
    "meta_data": {
      "customer_id": "CUST123456",
      "membership_level": "Gold",
      "preferred_language": "English",
      "verification_data": {
          "verified_by": "ThirdPartyService",
          "verification_date": "2024-07-01T10:00:00Z",
          "verification_status": "verified"
      }
    }
  }'

{
  "error": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found",
  "error_detail": {
    "code": "IDT_NOT_FOUND",
    "message": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found"
  }
}

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.

View identity details

Tokenize one field

curl -X PUT "http://localhost:5001/identities/{identity_id}" \
  -H "X-blnk-key: <api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "identity_type": "individual",
    "organization_name": "",
    "first_name": "Alice",
    "last_name": "Smith",
    "other_names": "Marie",
    "gender": "female",
    "dob": "1985-05-15T00:00:00Z",
    "email_address": "alice.smith@example.com",
    "phone_number": "+1234567890",
    "nationality": "Canadian",
    "category": "customer",
    "street": "789 Elm St",
    "country": "Canada",
    "state": "Ontario",
    "post_code": "M4B 1B3",
    "city": "Toronto",
    "meta_data": {
      "customer_id": "CUST123456",
      "membership_level": "Gold",
      "preferred_language": "English",
      "verification_data": {
          "verified_by": "ThirdPartyService",
          "verification_date": "2024-07-01T10:00:00Z",
          "verification_status": "verified"
      }
    }
  }'

{
  "error": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found",
  "error_detail": {
    "code": "IDT_NOT_FOUND",
    "message": "Identity with ID 'idt_c415a4dc-4231-453d-a837-a9a50b1070e0' not found"
  }
}

Start Here

Ledgers

Ledger balances

Transactions

Reconciliation

Identities

Metadata

Search

Transaction hooks

API keys

System

Authorization

Path

Body

Response

Need help?

​Authorization

​Path

​Body

​Response

​Need help?

Authorization

Path

Body

Response

Need help?