interactions.delete

Delete a logged interaction

Request: DELETE/api/v1/interactions/{interactionId}
Scope required: contacts:write
Effect: Deletes something. Confirm with a person before calling it.
Acts on: Acts on the account’s own job search.
MCP tool: interactions_delete
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Removes one interaction from a contact's history. The contact itself is untouched; use `contacts.delete` to remove the person and every interaction with them at once. This cannot be undone, and an interaction belonging to another account answers 404. Answers 204 with no body.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
interactionId	path	Required	string
If-Match	header	Optional	string — The ETag of the version you read. The write is refused with 412 if the resource has changed since.

Response

Answers 204 with no body.

Examples

Remove a conversation logged against the wrong person

Remove a conversation logged against the wrong person — request

curl -s -X DELETE https://www.jobapplicationtracking.com/api/v1/interactions/ix_88 \
  -H "Authorization: Bearer $JAT_KEY"

Remove a conversation logged against the wrong person — response

null