DEdexto
Data deletions

Delete an end user's or an agent's data

Delete data in the background. With user, deletes every session labelled with that end user in this key's Cloud project (or one agent), and every automation whose sessions carry the label. With only agent_id, archives the agent at once, pauses its automations, then deletes its sessions, automations, firings and versions; usage and spend keep its id and name. Usage and billing records are never deleted. While a user deletion is queued or running, new sessions for that user are refused with 409. A deletion that keeps failing ends failed with an error; requesting it again resumes it. At most 10 deletions per project are queued or running at once.

post/v1/data_deletions

Request

  • Base URL
    https://api.dexto.ai
  • URL
    https://api.dexto.ai/v1/data_deletions
  • Auth
    HTTP bearer

Request body

agent_idstring uuid nullable

Without user: the agent whose data to delete. With user: only that agent's sessions of the end user; null for every agent of this key's Cloud project.

userstring nullable

The end-user label whose sessions to delete, as you passed it when creating them. Never returned.

Response

Accepted.

completed_atstring date-time nullable required

When it completed or failed; null while it is queued or running.

created_atstring date-time required
idstring uuid required
object'data_deletion' required
status'queued' | 'running' | 'completed' | 'failed' required

Changes

No recorded changes to this operation across all 1 revision of this API.