Overwrite encoder key values
Overwrite (not accumulate — contrast with [Bulk-create encoder key values](/docs/api-reference/encoders/encoders-encodername-createkeyvalues-post)) the raw value/count/sum rows an Encoder holds for one categorical key (the key itself is the `key` path parameter below, not a DataFrame column). Each row: - **`Value`**: one of the key's observed values. - **`Count`**/**`Sum`**: replace whatever the encoder already holds for that value — this endpoint *overwrites*, it does not accumulate (see [Bulk-create encoder key values](/docs/api-reference/encoders/encoders-encodername-createkeyvalues-post) for an additive bulk insert).
Overwrite (not accumulate — contrast with
Bulk-create encoder key values)
the raw value/count/sum rows an Encoder holds for one categorical key
(the key itself is the key path parameter below, not a DataFrame
column). Each row:
Value: one of the key's observed values.Count/Sum: replace whatever the encoder already holds for that value — this endpoint overwrites, it does not accumulate (see Bulk-create encoder key values for an additive bulk insert).
Authorization
SymetryMLAuth HMAC-SHA256 signature-based authentication: requests are signed with
your secret key and sent with the Customer-ID, Sym-date,
Authorization, Content-MD5 and sym-version headers.
See SymetryML REST API Security
for the signature algorithm and a complete example.
In: header
Path Parameters
User/Customer identifier
The categorical attribute (key) name, not one of its values.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/c1/encoders/superenc0/keyvals/device_country/setValues" \ -H "Content-Type: application/json" \ -d '{ "attributeNames": [ "Value", "Type", "Count", "Sum" ], "data": [ [ "ca", "s", "123", "45" ], [ "us", "s", "456", "7" ] ] }'{ "statusCode": 200, "statusString": "OK", "values": {}}{ "statusCode": 400, "statusString": "Cannot Find Encoder[nosuchenc] for Customer[c1].", "values": {}}Get encoder key values GET
Get the raw key/value/count/sum rows an Encoder holds for one categorical key (the attribute name, not one of its values) — the finer-grained, per-value data that [Get encoder statistics](/docs/api-reference/encoders/encoders-encodername-stats-get) aggregates into per-key statistics. Compare/pair with [Bulk-create encoder key values](/docs/api-reference/encoders/encoders-encodername-createkeyvalues-post) (bulk insert) and [Overwrite encoder key values](/docs/api-reference/encoders/encoders-encodername-keyvals-key-setvalues-post) (overwrite) below.
Update encoder from an inline DataFrame POST
Update an Encoder's key statistics directly from an inline `DataFrame` in the request body — synchronous, no data source and no async job involved. The DataFrame must contain a column matching the encoder's target attribute name (set at [Create encoder](/docs/api-reference/encoders/encoders-create-post) time); every other column is treated as a categorical/binary input to encode against that target. This is the small-data counterpart to [Update encoder from a data source (async job)](/docs/api-reference/encoders/encoders-encodername-learnds-post), which instead schedules an async job to learn from a data source.