IBEx.Fi User Data Storage Flow

1. Store User Data Flow

💾

Store Data

POST /v1.1/ibexsafe/userdata
externalUserId + data (key/value)

🔒

Data Stored Securely

IBEX Safe (GDPR-compliant)
Private keys filtered

2. Retrieve User Data Flow

📖

Get Data

GET /v1.1/ibexsafe/userdata/external/:id
Returns key/value map

🔍

Data Retrieved

Private keys excluded
Flat key/value map

3. Update User Data Flow

✏️

Update Data

POST /v1.1/ibexsafe/userdata
Partial update supported

✅

Data Updated

Only specified keys updated
Other keys unchanged

4. Delete Key Flow

🗑️

Delete Key

POST /v1.1/ibexsafe/userdata
Set key to null

✅

Key Deleted

Key removed from storage
Other keys preserved

📋 Data to Store

externalUserId : User identifier (from JWT)
data : Key/value pairs (string, boolean, number, null)
private.* keys : Write-only sensitive data

🔧 Endpoints

1. Store Data
POST /v1.1/ibexsafe/userdata : Store/update user data
2. Retrieve Data
GET /v1.1/ibexsafe/userdata/external/:id : Get user data
3. Update Data
POST /v1.1/ibexsafe/userdata : Partial update
4. Delete Key
POST /v1.1/ibexsafe/userdata : Set key to null

⚙️ Technical Details

GDPR-compliant storage (IBEX Safe)
Private keys (write-only)
Partial updates supported
Flat key/value structure
JWT authentication required
Optional sign-in integration

← Back to User Data Guide