Update an entity by ID

curl --request PATCH \
  --url http://api.gu1.ai/entities/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "taxId": "<string>",
  "email": {},
  "phone": {},
  "nationality": {},
  "countryCode": "<string>",
  "attributes": {},
  "entityData": {},
  "status": "<string>",
  "reason": "<string>",
  "changeStatusManual": true,
  "riskMatrixId": [
    "<string>"
  ],
  "riskMatrixIds": [
    "<string>"
  ],
  "skipRulesExecution": true
}
'

import requests

url = "http://api.gu1.ai/entities/{id}"

payload = {
    "name": "<string>",
    "taxId": "<string>",
    "email": {},
    "phone": {},
    "nationality": {},
    "countryCode": "<string>",
    "attributes": {},
    "entityData": {},
    "status": "<string>",
    "reason": "<string>",
    "changeStatusManual": True,
    "riskMatrixId": ["<string>"],
    "riskMatrixIds": ["<string>"],
    "skipRulesExecution": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    taxId: '<string>',
    email: {},
    phone: {},
    nationality: {},
    countryCode: '<string>',
    attributes: {},
    entityData: {},
    status: '<string>',
    reason: '<string>',
    changeStatusManual: true,
    riskMatrixId: ['<string>'],
    riskMatrixIds: ['<string>'],
    skipRulesExecution: true
  })
};

fetch('http://api.gu1.ai/entities/{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 => "http://api.gu1.ai/entities/{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([
    'name' => '<string>',
    'taxId' => '<string>',
    'email' => [
        
    ],
    'phone' => [
        
    ],
    'nationality' => [
        
    ],
    'countryCode' => '<string>',
    'attributes' => [
        
    ],
    'entityData' => [
        
    ],
    'status' => '<string>',
    'reason' => '<string>',
    'changeStatusManual' => true,
    'riskMatrixId' => [
        '<string>'
    ],
    'riskMatrixIds' => [
        '<string>'
    ],
    'skipRulesExecution' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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 := "http://api.gu1.ai/entities/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"taxId\": \"<string>\",\n  \"email\": {},\n  \"phone\": {},\n  \"nationality\": {},\n  \"countryCode\": \"<string>\",\n  \"attributes\": {},\n  \"entityData\": {},\n  \"status\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"changeStatusManual\": true,\n  \"riskMatrixId\": [\n    \"<string>\"\n  ],\n  \"riskMatrixIds\": [\n    \"<string>\"\n  ],\n  \"skipRulesExecution\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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("http://api.gu1.ai/entities/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"taxId\": \"<string>\",\n  \"email\": {},\n  \"phone\": {},\n  \"nationality\": {},\n  \"countryCode\": \"<string>\",\n  \"attributes\": {},\n  \"entityData\": {},\n  \"status\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"changeStatusManual\": true,\n  \"riskMatrixId\": [\n    \"<string>\"\n  ],\n  \"riskMatrixIds\": [\n    \"<string>\"\n  ],\n  \"skipRulesExecution\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/entities/{id}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"taxId\": \"<string>\",\n  \"email\": {},\n  \"phone\": {},\n  \"nationality\": {},\n  \"countryCode\": \"<string>\",\n  \"attributes\": {},\n  \"entityData\": {},\n  \"status\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"changeStatusManual\": true,\n  \"riskMatrixId\": [\n    \"<string>\"\n  ],\n  \"riskMatrixIds\": [\n    \"<string>\"\n  ],\n  \"skipRulesExecution\": true\n}"

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

{
  "entity": {},
  "previousEntity": {}
}

PATCH

entities

{id}

Update an entity by ID

curl --request PATCH \
  --url http://api.gu1.ai/entities/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "taxId": "<string>",
  "email": {},
  "phone": {},
  "nationality": {},
  "countryCode": "<string>",
  "attributes": {},
  "entityData": {},
  "status": "<string>",
  "reason": "<string>",
  "changeStatusManual": true,
  "riskMatrixId": [
    "<string>"
  ],
  "riskMatrixIds": [
    "<string>"
  ],
  "skipRulesExecution": true
}
'

import requests

url = "http://api.gu1.ai/entities/{id}"

payload = {
    "name": "<string>",
    "taxId": "<string>",
    "email": {},
    "phone": {},
    "nationality": {},
    "countryCode": "<string>",
    "attributes": {},
    "entityData": {},
    "status": "<string>",
    "reason": "<string>",
    "changeStatusManual": True,
    "riskMatrixId": ["<string>"],
    "riskMatrixIds": ["<string>"],
    "skipRulesExecution": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    taxId: '<string>',
    email: {},
    phone: {},
    nationality: {},
    countryCode: '<string>',
    attributes: {},
    entityData: {},
    status: '<string>',
    reason: '<string>',
    changeStatusManual: true,
    riskMatrixId: ['<string>'],
    riskMatrixIds: ['<string>'],
    skipRulesExecution: true
  })
};

fetch('http://api.gu1.ai/entities/{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 => "http://api.gu1.ai/entities/{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([
    'name' => '<string>',
    'taxId' => '<string>',
    'email' => [
        
    ],
    'phone' => [
        
    ],
    'nationality' => [
        
    ],
    'countryCode' => '<string>',
    'attributes' => [
        
    ],
    'entityData' => [
        
    ],
    'status' => '<string>',
    'reason' => '<string>',
    'changeStatusManual' => true,
    'riskMatrixId' => [
        '<string>'
    ],
    'riskMatrixIds' => [
        '<string>'
    ],
    'skipRulesExecution' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "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 := "http://api.gu1.ai/entities/{id}"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"taxId\": \"<string>\",\n  \"email\": {},\n  \"phone\": {},\n  \"nationality\": {},\n  \"countryCode\": \"<string>\",\n  \"attributes\": {},\n  \"entityData\": {},\n  \"status\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"changeStatusManual\": true,\n  \"riskMatrixId\": [\n    \"<string>\"\n  ],\n  \"riskMatrixIds\": [\n    \"<string>\"\n  ],\n  \"skipRulesExecution\": true\n}")

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

	req.Header.Add("Authorization", "Bearer <token>")
	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("http://api.gu1.ai/entities/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"taxId\": \"<string>\",\n  \"email\": {},\n  \"phone\": {},\n  \"nationality\": {},\n  \"countryCode\": \"<string>\",\n  \"attributes\": {},\n  \"entityData\": {},\n  \"status\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"changeStatusManual\": true,\n  \"riskMatrixId\": [\n    \"<string>\"\n  ],\n  \"riskMatrixIds\": [\n    \"<string>\"\n  ],\n  \"skipRulesExecution\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/entities/{id}")

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

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"taxId\": \"<string>\",\n  \"email\": {},\n  \"phone\": {},\n  \"nationality\": {},\n  \"countryCode\": \"<string>\",\n  \"attributes\": {},\n  \"entityData\": {},\n  \"status\": \"<string>\",\n  \"reason\": \"<string>\",\n  \"changeStatusManual\": true,\n  \"riskMatrixId\": [\n    \"<string>\"\n  ],\n  \"riskMatrixIds\": [\n    \"<string>\"\n  ],\n  \"skipRulesExecution\": true\n}"

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

{
  "entity": {},
  "previousEntity": {}
}

Overview

Updates an existing entity’s attributes and data. When the entity has an assigned risk matrix whose triggers include entity_updated, the rules engine may run automatically after the update (respecting optional matrix watchFields and skipRulesExecution). Real-time update events and audit trails are always recorded.

Endpoint

PATCH http://api.gu1.ai/entities/{id}

Authentication

Requires a valid API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Path Parameters

string

required

The gu1 ID of the entity to update

Request Body

All fields from the create schema are available except type (entity type cannot be changed). All fields are optional - only include the fields you want to update.

string

Update the entity’s display name

External ID cannot be updated with this endpoint. Use Change external ID (POST /entities/change-external-id) with a mandatory reason (min. 5 characters). PATCH update routes ignore externalId in the body.

string

Update tax identification number

string | null

Update root-level contact email. Omit to leave unchanged; send null to clear.

string | null

Update root-level contact phone. Omit to leave unchanged; send null to clear.

string | null

Root nationality (ISO 3166-1 alpha-2 when stored). Omit to leave unchanged; null clears. Updating entityData person/company nationality may refresh the root field when sent together.

string

Update ISO 3166-1 alpha-2 country code

object

Update custom attributes (merges with existing top-level keys).Attributes are stored verbatim — the shape you send is the shape you get back on read.Uncategorized (flat): scalar or array values at the top level.

{ "phone": "+54...", "mcc": "5411" }

Categorized (nested): a top-level object groups its inner keys under that category. The object key is the category — use identifier-safe keys (e.g. contact, category_billing) so they work in rule paths.

{
  "contact": { "phone": "+54..." },
  "commercial": { "mcc": "5411" }
}

Rules and webhooks read the stored shape: flat keys as attributes.phone, nested keys as attributes.contact.phone.

object

Update type-specific data (merges with existing entityData)

string

Entity lifecycle status (active, inactive, blocked, under_review, suspended, pending_verification, expired, rejected, deleted).Required with reason: Any status change must include reason for audit.

string

Reason for the update (especially important when changing status to blocked or rejected).Required when: Changing status to blocked, rejected, or suspended.Best practice: Always provide a reason for audit trail purposes, even when not required.

boolean

default:"false"

When true, automatic status updates are disabled for this entity: risk matrix rules and automation actions such as set_entity_status do not change status. Manual updates via this endpoint (or the UI) still apply.

Default: false (rules and automations may change status when configured).
Set to false explicitly to remove the lock and allow automatic status changes again.
Does not disable risk score calculation or other rule side effects—only status writes from rules/automations.

Required with reason: if changeStatusManual changes (enable or disable), send reason in the same PATCH body for audit (same as status changes).

Risk Matrices

Assign or replace which risk matrices apply to this entity. Same semantics as Create entity (riskMatrixId / riskMatrixIds).

string | string[] | null

Legacy: one UUID, an array of UUIDs, or null to clear all assigned matrices. When riskMatrixIds is sent non-empty, it takes precedence over this field.

string[]

Preferred for multiple matrices: ordered list of UUIDs belonging to your organization. Send [] (or riskMatrixId: null) to remove all assignments. Each UUID must exist in your org; otherwise the API returns 400 with code INVALID_RISK_MATRIX.

boolean

default:"false"

When true, skips automatic risk matrix evaluation on update even if assigned matrices include the entity_updated trigger.

Updating matrices assigns them on the entity record only; assignment alone does not run rules.Rules on update: If the entity has at least one assigned matrix with trigger entity_updated, and skipRulesExecution is not true, the API runs the rules engine after a successful field change. Matrices may optionally restrict this with watchFields (only run when listed paths change, e.g. email, attributes.clientTypes). The entity.updated webhook includes rulesExecutionSummary when rules ran or were skipped with a reason.The same body fields apply to Update by external ID and PATCH /entities/by-tax-id/{taxId}.

Response

object

The updated entity object with all current values

object

The entity state before the update (for audit/comparison)

The HTTP response body does not include rulesExecutionSummary. When rules run (or are skipped), summary details are attached to the entity.updated webhook payload.

Behavior

When you update an entity, the system:

Records the change in the audit trail with before/after values
Runs risk matrices when assigned matrices include entity_updated, skipRulesExecution is not true, and optional watchFields on the matrix match changed paths
Emits real-time event to notify connected clients of the update
Fires entity.updated webhook with changes and optional rulesExecutionSummary

Examples

Update Person Income

curl -X PATCH http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityData": {
      "person": {
        "income": 95000,
        "occupation": "Senior Software Engineer"
      }
    }
  }'

const response = await fetch(
  'http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      entityData: {
        person: {
          income: 95000,
          occupation: 'Senior Software Engineer'
        }
      }
    })
  }
);

const result = await response.json();
console.log('Updated entity:', result.entity);
console.log('Re-evaluation triggered:', result.evaluation.id);

import requests

response = requests.patch(
    'http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'entityData': {
            'person': {
                'income': 95000,
                'occupation': 'Senior Software Engineer'
            }
        }
    }
)

result = response.json()
print(f"Updated entity: {result['entity']['name']}")
print(f"Re-evaluation ID: {result['evaluation']['id']}")

Update Company Information

curl -X PATCH http://api.gu1.ai/entities/660e9511-f39c-52e5-b827-557766551111 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityData": {
      "company": {
        "employeeCount": 75,
        "revenue": 7500000
      }
    },
    "attributes": {
      "partnershipTier": "platinum",
      "monthlyVolume": 500000
    }
  }'

const response = await fetch(
  'http://api.gu1.ai/entities/660e9511-f39c-52e5-b827-557766551111',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      entityData: {
        company: {
          employeeCount: 75,
          revenue: 7500000
        }
      },
      attributes: {
        partnershipTier: 'platinum',
        monthlyVolume: 500000
      }
    })
  }
);

const result = await response.json();
console.log('Company updated:', result.entity.name);
console.log('New revenue:', result.entity.entityData.company.revenue);

import requests

response = requests.patch(
    'http://api.gu1.ai/entities/660e9511-f39c-52e5-b827-557766551111',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'entityData': {
            'company': {
                'employeeCount': 75,
                'revenue': 7500000
            }
        },
        'attributes': {
            'partnershipTier': 'platinum',
            'monthlyVolume': 500000
        }
    }
)

result = response.json()
print(f"Company updated: {result['entity']['name']}")
print(f"New revenue: ${result['entity']['entityData']['company']['revenue']:,}")

Update Custom Attributes Only

curl -X PATCH http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "attributes": {
      "accountTier": "premium",
      "loyaltyPoints": 15000,
      "lastLoginDate": "2024-10-03T14:00:00Z"
    }
  }'

const response = await fetch(
  'http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      attributes: {
        accountTier: 'premium',
        loyaltyPoints: 15000,
        lastLoginDate: '2024-10-03T14:00:00Z'
      }
    })
  }
);

const result = await response.json();
console.log('Attributes updated:', result.entity.attributes);

import requests

response = requests.patch(
    'http://api.gu1.ai/entities/550e8400-e29b-41d4-a716-446655440000',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'attributes': {
            'accountTier': 'premium',
            'loyaltyPoints': 15000,
            'lastLoginDate': '2024-10-03T14:00:00Z'
        }
    }
)

result = response.json()
print(f"Attributes updated: {result['entity']['attributes']}")

Update Transaction Status

curl -X PATCH http://api.gu1.ai/entities/770f0622-g40d-63f6-c938-668877662222 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entityData": {
      "transaction": {
        "status": "reviewed",
        "flagged": false
      }
    }
  }'

const response = await fetch(
  'http://api.gu1.ai/entities/770f0622-g40d-63f6-c938-668877662222',
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      entityData: {
        transaction: {
          status: 'reviewed',
          flagged: false
        }
      }
    })
  }
);

const result = await response.json();
console.log('Transaction status updated');

import requests

response = requests.patch(
    'http://api.gu1.ai/entities/770f0622-g40d-63f6-c938-668877662222',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'entityData': {
            'transaction': {
                'status': 'reviewed',
                'flagged': False
            }
        }
    }
)

result = response.json()
print("Transaction status updated")

Response Example

{
  "entity": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "externalId": "customer_12345",
    "organizationId": "8e2f89ab-c216-4eb4-90eb-ca5d44499aaa",
    "type": "person",
    "name": "María González",
    "taxId": "20-12345678-9",
    "countryCode": "AR",
    "riskScore": 22,
    "riskFactors": [...],
    "status": "active",
    "kycVerified": true,
    "entityData": {
      "person": {
        "firstName": "María",
        "lastName": "González",
        "dateOfBirth": "1985-03-15",
        "nationality": "AR",
        "occupation": "Senior Software Engineer",
        "income": 95000
      }
    },
    "attributes": {
      "email": "maria.gonzalez@example.com",
      "phone": "+54 11 1234-5678",
      "accountTier": "premium"
    },
    "createdAt": "2024-10-03T14:30:00.000Z",
    "updatedAt": "2024-10-03T16:45:00.000Z",
    "deletedAt": null
  },
  "evaluation": {
    "id": "eval_new_123",
    "entityId": "550e8400-e29b-41d4-a716-446655440000",
    "decision": "PENDING",
    "evaluationType": "SYSTEM",
    "reasons": ["Re-evaluation triggered by attribute change"],
    "rules": [],
    "entitySnapshot": {...}
  },
  "previousEntity": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "entityData": {
      "person": {
        "occupation": "Software Engineer",
        "income": 85000
      }
    },
    "updatedAt": "2024-10-03T14:35:00.000Z"
  }
}

Error Responses

404 Not Found

{
  "error": "Entity not found"
}

400 Bad Request - Invalid Data

{
  "error": "Validation failed",
  "details": ["Invalid country code format"]
}

401 Unauthorized

{
  "error": "Invalid or missing API key"
}

500 Internal Server Error

{
  "error": "Failed to update entity"
}

Use Cases

Update After KYC Verification

// After completing KYC verification, update the entity
const response = await fetch(`http://api.gu1.ai/entities/${entityId}`, {
  method: 'PATCH',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    attributes: {
      kycVerified: true,
      kycVerificationDate: new Date().toISOString(),
      kycProvider: 'manual_review'
    }
  })
});

Progressive Profile Enrichment

# Enrich customer profile as more information becomes available
def update_customer_info(entity_id, new_data):
    response = requests.patch(
        f'http://api.gu1.ai/entities/{entity_id}',
        headers={
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/json'
        },
        json={
            'entityData': {
                'person': new_data
            },
            'attributes': {
                'lastDataUpdate': datetime.now().isoformat(),
                'dataCompleteness': calculate_completeness(new_data)
            }
        }
    )
    return response.json()

Transaction Resolution

// Mark a flagged transaction as resolved after investigation
async function resolveTransaction(txnId, resolution) {
  const response = await fetch(`http://api.gu1.ai/entities/${txnId}`, {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      entityData: {
        transaction: {
          status: 'resolved',
          flagged: false
        }
      },
      attributes: {
        resolutionDate: new Date().toISOString(),
        resolutionNotes: resolution,
        reviewedBy: 'compliance_team'
      }
    })
  });

  return response.json();
}

Best Practices

Partial Updates: Only send the fields you want to change - no need to send the entire entity
Monitor Re-evaluations: Check the returned evaluation ID to track risk score recalculation
Audit Trail: Use the previousEntity in the response to maintain change history
Real-time Sync: Updates emit WebSocket events for real-time UI synchronization
Idempotency: Safe to retry - updates with same data will not create duplicate events

Next Steps

Get Entity - View updated entity details
List Entities - Query entities with filters
Upsert Entity - Create or update in one operation
Request AI Analysis - Get updated risk assessment

⌘I

​Overview

​Endpoint

​Authentication

​Path Parameters

​Request Body

​Risk Matrices

​Response

​Behavior

​Examples

​Update Person Income

​Update Company Information

​Update Custom Attributes Only

​Update Transaction Status

​Response Example

​Error Responses

​404 Not Found

​400 Bad Request - Invalid Data

​401 Unauthorized

​500 Internal Server Error

​Use Cases

​Update After KYC Verification

​Progressive Profile Enrichment

​Transaction Resolution

​Best Practices

​Next Steps

Overview

Endpoint

Authentication

Path Parameters

Request Body

Risk Matrices

Response

Behavior

Examples

Update Person Income

Update Company Information

Update Custom Attributes Only

Update Transaction Status

Response Example

Error Responses

404 Not Found

400 Bad Request - Invalid Data

401 Unauthorized

500 Internal Server Error

Use Cases

Update After KYC Verification

Progressive Profile Enrichment

Transaction Resolution

Best Practices

Next Steps