---
title: Tenant Operations
description: Organization metadata, account lifecycle, metrics, and semantic search.
surface: shared
---

Tenant operations cover organization metadata, usage metrics, semantic search, and account lifecycle teardown for the Agent surface.

## Organization Metadata

- `GET /agent/v0/organizations`

Agentry maps this endpoint to the authenticated tenant and returns snake_case fields such as `organization_id` and `daily_send_limit`.

## Usage Metrics

- `GET /agent/v0/metrics`
- `GET /agent/v0/inboxes/{inbox_id}/metrics`
- `GET /agent/v0/pods/{pod_id}/metrics`

Metrics aggregate usage logs over a time window (`since`/`until`) and return counters like `emails_sent`.

## Semantic Search

- `POST /agent/v0/search`

Search is scoped to inboxes visible to the tenant (optionally narrowed by `inbox_ids` and `pod_ids`) and returns semantic matches as message-level result objects.

## Account Deletion

- `DELETE /agent/v0/account`

Account deletion removes tenant data and triggers cleanup side effects (including mailbox/domain resource cleanup and object storage purge).