Skip to main content
An anonymization is the anonymized copy of one trace; its API object is 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.
Returns 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: