---
id: SCR-PFM-QRY-017
title: Custom query table library (Rhythm HQ)
route: /hq/customQueryTables
surface: console
product_area: platform
module: queries
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: Let authorized Rhythm staff inspect custom-table definitions and reserve a new table identity.
supports:
  - CAP-PFM-QRY-005
permission: hq.custom-query-tables.read; creating needs hq.custom-query-tables.author
entry_from:
  - Rhythm HQ navigation
exits_to:
  - '/hq/customQueryTables/{id}'
displays:
  - field: >-
      Definition name, released version, assignment scope, usage count, update time and
      availability.
    source: listCustomQueryTables
actions:
  - label: New Custom Table
    operation_id: createCustomQueryTable
    permission: hq.custom-query-tables.author
    confirm: false
  - label: Open
    operation_id: getCustomQueryTable
    permission: hq.custom-query-tables.read
    confirm: false
states:
  - staff catalog loading
  - no custom definitions
  - catalog error
  - staff access refused
validation:
  - BR-CAP-PFM-QRY-005-01
  - BR-CAP-PFM-QRY-005-02
patterns:
  - Full layout (PageLayout default)
  - staff gate
  - definitions table
  - new table dialog
component: >-
  components/custom-query-tables/custom-tables-screen.tsx, custom-table-list.tsx,
  new-table-dialog.tsx, staff-gate.tsx
evidence:
  - >-
    react-console at baf6dae: app/(console)/hq/customQueryTables/page.tsx;
    components/custom-query-tables/*.tsx; lib/api/custom-query-tables.ts
controls: [TC-AVL-001, 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-IAM-001, TC-IAM-002, TC-IAM-003, TC-IAM-004, TC-IAM-005, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-PI-001, TC-PI-003, TC-PI-005, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# Custom query table library (Rhythm HQ)

## What the Screen Is For

Let authorized Rhythm staff inspect custom-table definitions and reserve a new table identity.

## What It Shows and Lets People Do

The library opens a selected definition or creates a permanent identity through the new-table dialog. Its staff gate separates this authoring tool from customer query consumption.

## States and Errors

Loading, absence and failed requests have separate states. Customers do not receive authoring access from a workspace query grant.

## Patterns It Must Respect

The full-width staff PageLayout uses the definition table and existing identity dialog with the staff gate.