users_touches_discard

Tool

users_touches_discard

Discard a touch you logged.

Discard a touch you logged. A touch somebody ELSE logged answers 404, exactly as a touch that does not exist does. Pass `force: true` to remove it anyway, which is recorded in the audit trail along with the original author. There is no undo.

Behavior

HTTP: DELETE /users/users/:userId/touches/:touchId

Arguments

Name	Type	Required	Description
force	boolean	—	Act on a touch somebody else logged. Without it a touch you did not author answers 404, exactly as a touch that does not exist does — the refusal must not tell you the row is there. Every forced call is recorded in the audit trail.
userId	string	•	The end user the touch belongs to.
touchId	string	•	The touch to delete, from users_touches_list.

Response

Field	Type	Always	Description
id	string	•	Id of the touch that was deleted.
userId	string	•	The end user it belonged to.
deleted	boolean	•	Always true — a failure answers 404 instead.

Try it

Discard a touch you logged.

When to use

Example

Ask your agent something like this:

Discard a touch you logged.

The agent will invoke users_touches_discard with these arguments:

{
  "userId": "<userId>",
  "touchId": "<touchId>"
}