---
title: "Admin Debug Lookup"
method: GET
path: "/api/admin/debug/lookup"
tags: ["admin-debug"]
---

# Admin Debug Lookup

`GET /api/admin/debug/lookup`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/admin/debug/lookup`
- Auth: HTTP bearer

Search agents and sessions by team name, user email, or agent identity.

Returns two parallel lists (agents and sessions) plus totals, for the
Session Debug admin UI to render as tabs. At least one of `team_name`,
`user_email`, `agent_id`, or `agent_name` must be provided. Multiple
filters AND together.

## Query parameters

- `team_name` string, nullable: Partial team name match (ilike)
- `user_email` string, nullable: Partial user email match (ilike)
- `agent_id` string, uuid, nullable: Exact match on agents.id
- `agent_name` string, nullable: Partial agent name match (ilike)
- `limit` integer

## Response `200`

Successful Response

- LookupResponse
  - `agents` LookupAgentItem[], required
    - `id` string, required
    - `name` string, required
    - `status` string, required
    - `owner_user_id` string, required
    - `owner_email` string, required
    - `team_id` string, nullable, required
    - `team_name` string, nullable, required
    - `session_count` integer, required
    - `created_at` string, date-time, required
    - `last_active_at` string, date-time, nullable, required
  - `sessions` LookupSessionItem[], required
    - `conversation_id` string, required
    - `title` string, nullable, required
    - `agent_id` string, required
    - `agent_name` string, required
    - `user_id` string, required
    - `user_email` string, required
    - `team_id` string, nullable, required
    - `team_name` string, nullable, required
    - `message_count` integer, required
    - `last_message_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total_agents` integer, required
  - `total_sessions` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)