---
updatedAt: 2026-04-26T11:14:16.000Z
agentTools:
  projectIndex: https://deepchecks.readme.io/llms.txt
---

# Delete Interactions

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Deepchecks LLM Evaluation",
    "description": "Deepchecks LLM Evaluation and Monitoring API Spec",
    "version": "0.1.0"
  },
  "paths": {
    "/api/v1/application-versions/{application_version_id}/interactions": {
      "delete": {
        "tags": [
          "interactions"
        ],
        "summary": "Delete Interactions",
        "operationId": "delete_interactions_api_v1_application_versions__application_version_id__interactions_delete",
        "security": [
          {
            "AccessBearer": [
              "INTERACTIONS_WRITE"
            ]
          },
          {
            "ApiKeyAuth": []
          }
        ],
        "parameters": [
          {
            "name": "application_version_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "title": "Application Version Id"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/FilterSchema"
                  },
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Filter for interactions to delete or list of user interaction ids.",
                "title": "Deletion Filter"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {}
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AnnotationFilterSchema": {
        "properties": {
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AnnotationSource"
              },
              {
                "type": "null"
              }
            ]
          },
          "value": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AnnotationType"
              },
              {
                "type": "string",
                "const": "pending"
              }
            ],
            "title": "Value"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "value"
        ],
        "title": "AnnotationFilterSchema"
      },
      "AnnotationOrigin": {
        "type": "string",
        "enum": [
          "user",
          "llm",
          "similarity",
          "property",
          "garak",
          "Deepchecks Evaluator",
          "children",
          "Passed All Tests"
        ],
        "title": "AnnotationOrigin"
      },
      "AnnotationSource": {
        "type": "string",
        "enum": [
          "user_annotated",
          "estimated"
        ],
        "title": "AnnotationSource"
      },
      "AnnotationType": {
        "type": "string",
        "enum": [
          "good",
          "bad",
          "unknown"
        ],
        "title": "AnnotationType"
      },
      "DataFilter": {
        "properties": {
          "column": {
            "type": "string",
            "title": "Column"
          },
          "operator": {
            "$ref": "#/components/schemas/Operator"
          },
          "value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "string"
              },
              {
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "type": "array"
              },
              {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Value"
          },
          "property_type": {
            "$ref": "#/components/schemas/TableType"
          }
        },
        "type": "object",
        "required": [
          "column",
          "operator",
          "value",
          "property_type"
        ],
        "title": "DataFilter"
      },
      "EnvType": {
        "type": "string",
        "enum": [
          "PROD",
          "EVAL",
          "PENTEST"
        ],
        "title": "EnvType",
        "description": "does not include sampled env types"
      },
      "FilterSchema": {
        "properties": {
          "start_time_epoch": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start Time Epoch"
          },
          "end_time_epoch": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "End Time Epoch"
          },
          "prop_filters": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DataFilter"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prop Filters"
          },
          "annotations": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/AnnotationFilterSchema"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Annotations"
          },
          "annotation_origins": {
            "anyOf": [
              {
                "items": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/AnnotationOrigin"
                    },
                    {
                      "type": "string",
                      "const": "no-origin"
                    }
                  ]
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Annotation Origins"
          },
          "annotated_by": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array",
                "maxItems": 20
              },
              {
                "type": "null"
              }
            ],
            "title": "Annotated By"
          },
          "annotation_assignee": {
            "anyOf": [
              {
                "items": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "string",
                      "const": "unassigned"
                    }
                  ]
                },
                "type": "array",
                "maxItems": 20
              },
              {
                "type": "null"
              }
            ],
            "title": "Annotation Assignee"
          },
          "user_estimated_annotation_diff": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Estimated Annotation Diff"
          },
          "interaction_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Interaction Type",
            "deprecated": true
          },
          "interaction_type_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Interaction Type Id"
          },
          "interaction_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Interaction Name"
          },
          "parent_interaction_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parent Interaction Name"
          },
          "environment": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/EnvType"
              },
              {
                "items": {
                  "$ref": "#/components/schemas/EnvType"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Environment"
          },
          "order_by": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/OrderBySchema"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Order By"
          },
          "user_interaction_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array",
                "maxItems": 1000
              },
              {
                "type": "null"
              }
            ],
            "title": "User Interaction Ids",
            "description": "List of user interaction IDs to filter by. Maximum 1000 items allowed."
          },
          "session_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array",
                "maxItems": 1000
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Ids",
            "description": "List of session IDs to filter by. Maximum 1000 items allowed."
          },
          "topics": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Topics"
          },
          "span_names": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Span Names"
          },
          "search": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SearchSchema"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "FilterSchema"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "Operator": {
        "type": "string",
        "enum": [
          "GE",
          "GT",
          "LE",
          "LT",
          "EQ",
          "NEQ",
          "IN",
          "NIN",
          "OVERLAP",
          "CONTAINS"
        ],
        "title": "Operator",
        "description": "Operators for numeric and categorical filters."
      },
      "OrderByDirection": {
        "type": "string",
        "enum": [
          "asc",
          "desc"
        ],
        "title": "OrderByDirection"
      },
      "OrderByModel": {
        "type": "string",
        "enum": [
          "annotations",
          "interactions",
          "properties",
          "similarity",
          "application_versions",
          "input_properties",
          "output_properties",
          "custom_properties",
          "llm_properties",
          "garak_properties"
        ],
        "title": "OrderByModel"
      },
      "OrderBySchema": {
        "properties": {
          "column": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "$ref": "#/components/schemas/SimilarityMetricEnum"
              }
            ],
            "title": "Column"
          },
          "model": {
            "$ref": "#/components/schemas/OrderByModel"
          },
          "direction": {
            "$ref": "#/components/schemas/OrderByDirection",
            "default": "asc"
          },
          "similarity_version": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Similarity Version"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "column",
          "model"
        ],
        "title": "OrderBySchema"
      },
      "SearchSchema": {
        "properties": {
          "text": {
            "type": "string",
            "title": "Text"
          },
          "case_sensitive": {
            "type": "boolean",
            "title": "Case Sensitive",
            "default": false
          },
          "accent_sensitive": {
            "type": "boolean",
            "title": "Accent Sensitive",
            "default": false
          },
          "field_names": {
            "items": {
              "type": "string",
              "enum": [
                "output",
                "input",
                "user_interaction_id",
                "session_id",
                "annotation_reason",
                "span_name",
                "trace_id",
                "metadata",
                "agent_ancestor"
              ]
            },
            "type": "array",
            "uniqueItems": true,
            "title": "Field Names"
          },
          "is_exact": {
            "type": "boolean",
            "title": "Is Exact",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "text",
          "field_names"
        ],
        "title": "SearchSchema"
      },
      "SimilarityMetricEnum": {
        "type": "string",
        "enum": [
          "similarity",
          "blue_1_similarity",
          "rouge_1_similarity"
        ],
        "title": "SimilarityMetricEnum"
      },
      "TableType": {
        "type": "string",
        "enum": [
          "input",
          "output",
          "custom",
          "llm",
          "garak",
          "topic",
          "interaction",
          "span"
        ],
        "title": "TableType"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError"
      }
    },
    "securitySchemes": {
      "AccessBearer": {
        "type": "oauth2",
        "flows": {
          "password": {
            "scopes": {},
            "tokenUrl": "/token"
          }
        }
      },
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization"
      }
    }
  },
  "servers": [
    {
      "url": "https://app.llm.deepchecks.com/"
    }
  ]
}
```