---
id: SCR-PFM-LLM-004
title: Rhythm HQ AI usage requests
route: /hq/aiUsage/requests
surface: console
product_area: platform
module: llm
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: Locate an organization’s model requests through staff-only history filters.
supports:
  - JNY-PFM-LLM-002
  - CAP-PFM-LLM-011
permission: hq.llm-usage.read
entry_from:
  - SCR-PFM-LLM-003
  - SCR-PFM-LLM-007
exits_to:
  - SCR-PFM-LLM-005
  - SCR-PFM-LLM-006
  - SCR-PFM-LLM-003
displays:
  - field: 'Request timing, routing, status, task, caller, cost and latency'
    source: listHqTenantLlmUsageInvocations
  - field: Selectable organizations loaded through usage reporting
    source: listHqLlmUsageTenants
actions:
  - label: Choose an organization
    operation_id: 'none: sets the organization in the address'
    permission: hq.llm-usage.read
    confirm: false
  - label: 'Filter by from and to dates, operation, model, status, task and person'
    operation_id: listHqTenantLlmUsageInvocations
    permission: hq.llm-usage.read
    confirm: false
  - label: Load more
    operation_id: listHqTenantLlmUsageInvocations (next cursor)
    permission: hq.llm-usage.read
    confirm: false
  - label: Open a request / Open its task
    operation_id: 'none: navigates to the request or task detail'
    permission: hq.llm-usage.read
    confirm: false
states:
  - 'empty: choose an organization or inspect a no-results message'
  - 'loading: skeleton rows represent the selected history'
  - 'error: initial and additional pages fail separately'
  - 'read-only: request history is inspection only'
  - 'permission denied: the staff usage read is unavailable'
validation:
  - BR-CAP-PFM-LLM-011-01
  - BR-CAP-PFM-LLM-011-05
  - BR-CAP-PFM-LLM-011-06
patterns:
  - Standard layout with back link to AI Usage
  - 'HQ list parts (filter selects, skeleton rows, load more, empty states)'
  - Keyset pagination
component: components/console/hq/ai-usage/ai-usage-requests.tsx
evidence:
  - >-
    react-console at baf6dae: app/(console)/hq/aiUsage/requests/page.tsx;
    components/console/hq/ai-usage/ai-usage-requests.tsx; components/console/hq/list-parts.tsx;
    lib/hq/ai-usage.ts; e2e/mock/hq-ai-usage.mock.spec.ts.
controls: [TC-AI-006, TC-AI-007, TC-AVL-004, TC-AVL-005, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-AZ-006, TC-CRY-001, TC-CRY-002, TC-CRY-003, TC-CRY-004, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-IAM-001, TC-IAM-002, TC-IAM-003, TC-IAM-004, TC-IAM-005, TC-IAM-006, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-PI-001, TC-PI-002, TC-PI-003, TC-PI-004, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# Rhythm HQ AI usage requests

## What the Screen Is For

Support chooses an organization and narrows its history to the request under investigation.

## What It Shows and Lets People Do

The table lists requests with operation, model, caller, task, charge and latency. Date range and technical filters narrow the selected organization’s list. Request and task links open detail pages; keyset pagination fetches additional rows. Captured content is excluded.

## States and Errors

Before selection the page asks for an organization. Skeleton rows represent loading, read failures offer retry and further-page failures have a separate state. Invalid filters are rejected by the service.

## Patterns It Must Respect

The existing HQ list uses PageLayout, BackLink, filter controls, loading rows and a Load More action.