These KVPs are “loosely typed” - all values are stored as strings, though you
can specify a type to provide usage hints. Note that type specifications are
generally not strictly enforced.
Understanding KVP Types
KVP types help describe the data content and its intended use. Here’s what you need to know about the different categories:Basic Types
Basic Types
general.*- For common data types (string, integer, float, etc.)raw.*- For storing binary or unprocessed data (Base64 encoded)
Identifier Types
Identifier Types
id.*- For data that can be used to create document objects/entitiesid.external- For capturing external service IDs (searchable in the index)
id.external is distinct from result.id. When attached to an entity’s
extraData KVP array, id.external values become searchable via the /search
API.Special Purpose Types
Special Purpose Types
defunct- Marks deleted KVPs where value retention is requiredresult.*- Captures external service responses and transaction IDserror.*- Handles non-critical error informationtransient.*- Temporary values that exist only during the initial service call
Complete Type Reference
- Basic Types
- Raw Data Types
- Result & Error Types
- ID Types
- PII Types
- Address Types
Best Practice
When working with sensitive data that needs to be used only once, consider usingtransient.* types. These values are processed during the initial call
but aren’t persisted in storage.