---
id: SCR-PFM-SEC-027
title: HQ workspace detail
route: /hq/tenants/{id}
surface: console
product_area: platform
module: security
revision: 1
status: draft
design_intent: proposed
implementation_evidence: observed
inference: []
source_sha:
  react-console: baf6dae382d6f41dce976c7f848667ccc37e076f
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
purpose: Inspect an HQ workspace and edit the built staff fields without direct lifecycle controls.
supports:
- JNY-PFM-SEC-001
- CAP-PFM-SEC-002
- CAP-PFM-SEC-003
permission: hq.tenants.read
entry_from:
- /hq/tenants
- /hq/customers/{id}
- /hq
exits_to:
- /console/{tenantId}
- /hq/jobs/{kind}/{id}
displays:
- field: Workspace identity, customer, classification, parent/children, business status, lifecycle, time zone
    and references.
  source: getHqTenant
  provenance: observed
- field: Provisioning job and participant-step progress.
  source: getTenantProvisioning
  provenance: observed
- field: Sender identity and verification information.
  source: getHqTenantEmailSender
  provenance: observed
- field: Hosted license and AI-usage sections with their separately owned operations and permissions.
  source: Licensing and LLM operations
  provenance: observed
actions:
- label: Edit (name, acronym, time zone, status)
  operation_id: patchHqTenant
  permission: hq.tenants.update (status also platform.tenants.manage-status)
  confirm: true
  provenance: observed
  source: react-console:components/console/hq/tenant-detail.tsx
  confirmation_condition: Only disabling business status asks for confirmation.
- label: Retry provisioning
  operation_id: retryTenantProvisioning
  permission: hq.tenants.provision
  confirm: false
  provenance: observed
  source: react-console:components/console/hq/tenant-detail.tsx
- label: Enter
  operation_id: recordMyHqTenantShortcutOpened
  permission: hq.tenants.read
  confirm: false
  provenance: observed
  source: react-console:components/console/hq/tenant-detail.tsx
states:
- loading
- error
- read-only
- inactive
validation:
- BR-CAP-PFM-SEC-002-02
- BR-CAP-PFM-SEC-002-04
- BR-CAP-PFM-SEC-002-06
- BR-CAP-PFM-SEC-002-14
- BR-CAP-PFM-SEC-003-05
patterns:
- StaffOnly
- PageLayout
- PageHeader
- Workspace edit sheet
- Unsaved-change guard
- Disable confirmation dialog
component: components/console/hq/tenant-detail.tsx (TenantDetail)
evidence:
- 'react-console at baf6dae: components/console/hq/tenant-detail.tsx; the page route file; lib/security/api.ts,
  lib/hq/platform-ops.ts, lib/hq/platform.ts, lib/auth/*'
examined_at: '2026-10-23'
examiner: codex
controls: [TC-AVL-001, 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-CHG-001, TC-CHG-002, TC-CHG-003, TC-CHG-004, TC-CHG-005, TC-CHG-006, TC-CHG-007, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-DAT-004, TC-IAM-001, TC-IAM-002, TC-IAM-003, TC-IAM-004, TC-IAM-005, TC-LOG-001, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-MON-002, TC-MON-003, 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-TEN-004, TC-VEN-001, TC-VEN-002, TC-VEN-003]
---

# HQ workspace detail

## What the Screen Is For

Inspect an HQ workspace and edit the built staff fields without direct lifecycle controls.

## What It Shows and Lets People Do

The detail page reads workspace and hosted sections under their respective keys. Workspace editing uses update authority; business-status changes also need status-management authority. Only disabling opens the extra confirmation, while other saves do not.

## States and Errors

Provisioning retry and workspace entry use their dedicated operations. Loading, reset and retirement are not controls on this page. Hosted AI usage is metering display, not an inference operation made by this module.

The state rows describe observed loading, empty, refusal or inactive handling where present. Linked validation rules belong to the planning layer; client feedback and authoritative service checks have distinct responsibilities.

## Patterns It Must Respect

The pattern list names the built shared components and interaction patterns checked for this screen. This contract describes the existing screen; it supplies no replacement visual design.