twin. Create one per trace, or many at once with a batch.
Each anonymization draws its own synthetic values: consistent within the anonymization, unlinked across anonymizations.
The anonymization object
Statuses
An anonymization reaches
completed unless its input causes a failure. Errors on our side are retried automatically. Failed anonymizations are not charged, and an anonymization is not charged while paused. A batch’s anonymizations do not pause; their batch does.
Create an anonymization
POST /v1/kennet/twins
Uploads one trace and creates its anonymization. Send multipart/form-data with an Idempotency-Key header.
202 with a twin object, status: queued, and a Location header. If what the organization can spend (balance plus credit limit, less anonymizations in progress) does not cover the anonymization, the request still succeeds: the anonymization moves to paused, sends kennet.twin.paused, and starts by itself when credit is added or other anonymizations finish, sending kennet.twin.resumed.
Retrieve an anonymization
GET /v1/kennet/twins/{id}
Retrieves an anonymization.
Returns a twin object, or 404 resource_missing if this key’s organization and mode have no anonymization with that ID.
List anonymizations
GET /v1/kennet/twins
Lists anonymizations, newest first, including anonymizations created by batches.
Returns
{object: "list", data, has_more, url}, with twin objects in data. If has_more is true, pass the last id as starting_after for the next page.
Download an anonymization’s content
GET /v1/kennet/twins/{id}/content
Downloads the anonymized file of a completed anonymization.
Returns 200 with the file as an attachment, under the uploaded file’s name, in its format: