---
title: "Delete By Metadata"
method: POST
path: "/public/v2/org-jobs/delete-by-metadata"
tags: ["Organization Jobs"]
---

# Delete By Metadata

`POST /public/v2/org-jobs/delete-by-metadata`

## Request

- Base URL: `https://api.galileo.ai`
- URL: `https://api.galileo.ai/public/v2/org-jobs/delete-by-metadata`
- Auth: one of:
  - API key in header `Splunk-AO-API-Key`
  - API key in header `Galileo-API-Key`
  - OAuth 2
    - Password
    - Token URL: `https://api.galileo.ai/login`
  - HTTP basic

Delete traces/sessions across all projects in the organization by metadata filters.

This endpoint allows organization administrators to delete traces or sessions
that match specific metadata key-value pairs across all projects in their
organization.

## Query parameters

- `immediate` boolean

## Request body

- OrgMetadataDeleteRequest: Request body for organization-wide metadata-based deletion.
  - `metadata_key` string, required
  - `metadata_value` string, required

## Response `200`

Successful Response

- OrgMetadataDeleteResponse: Response for organization-wide metadata-based deletion.
  - `job_id` string, uuid4, nullable, required
  - `message` string, required

## Other responses

- `422`: Validation Error

## Changes

> 34 revisions in range; 2 not diffed.

- **2026-07-26** `05003e7835a2`: 1 info
  - the endpoint scheme security `ClassicAPIKeyHeader` was added to the API

[Operation history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/public/v2/org-jobs/delete-by-metadata/post.md)

---

[API](https://skmtc.dev/galileo/apis/galileo-api-server.md) - [All operations](https://skmtc.dev/galileo/apis/galileo-api-server/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo/apis/galileo-api-server/revisions/a289cea1b504?raw)