---
id: TST-PFM-SEC-222
title: HQ workspaces request checks
kind: api-lifecycle
product_area: platform
module: security
revision: 2
status: draft
source_sha:
  services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1
repository: services-platform
files:
  - modules/tenants/tests/e2e/hq-tenants.e2e.spec.js
implements:
  - ATS-PFM-SEC-002-11
environment: local
implementation_state: implemented
latest_result: not-run
latest_run_at: null
latest_run_ref: null
conformance: not-verified
estimated_minutes: 5
isolation: Use the prepared test database and suite-owned fixture rows; retain shared seed records.
assertion_evidence:
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#the HQ tenant list (end to
      end)
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#serves a staff member
      holding hq.tenants.read and nothing else
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers a page of records,
      each with its customer name, and no cursor when it is the last
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#finds a tenant by its id,
      the association's domain, whatever its case
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers no domain on a
      record, the id being the tenant’s one identifier
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers a cursor that
      resumes the list where the page stopped
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses a limit that is not
      a whole number as 400
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses a status the closed
      list does not have as 400
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses a cursor this list
      did not make as 400
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers only the tenants of
      the type asked for
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers the other tenants
      for the type they were left at, so the filter is not matching by accident
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses a type the closed
      list does not have as 400
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses a staff member who
      holds another HQ key but not hq.tenants.read as 403
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses an administrator of
      a customer, holding every key at that customer, as 403
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses an anonymous call
      as 401
  - provenance: test
    source: 'services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#reading one tenant'
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#serves a staff member
      holding hq.tenants.read and nothing else
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers the tenant with its
      customer's name and its sandboxes
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers the parent's name
      for a tenant that has a parent
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#carries no parent_name for
      a tenant that has no parent, and an empty sandbox list
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#answers 404 for a tenant
      that does not exist
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses a staff member who
      holds another HQ key but not hq.tenants.read as 403
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses an administrator of
      a customer as 403, even for their own tenant
  - provenance: test
    source: >-
      services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js#refuses an anonymous read
      as 401
dependency_evidence: >-
  The local request harness exercises the route dispatcher and the prepared database. The suite
  controls the signing key at the declared seams; those collaborators remain outside its live proof.
evidence:
  - 'services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js'
  - >-
    Static review at the recorded source revision; executable results remain not-run and conformance
    remains not-verified.
binding_note: >-
  Each binding names the scenario to which this file contributes assertions. A binding is not a
  recorded pass and does not extend the file’s dependency boundary.
examiner: codex
examined_at: '2026-10-23'
final_text: OpenAI
dependency_review:
  provenance: test
  source: 'services-platform:modules/tenants/tests/e2e/hq-tenants.e2e.spec.js'
  explicit_no_doubles: false
  identified_double_boundaries:
    - the signing key
---
# HQ workspaces request checks

## Verification Boundary

The file exercises public request handling through the local service harness. The assertion references identify the source checks for HQ workspaces.

## What This Suite Proves

The source assertions support the observations named in the bound scenarios. A scenario spanning multiple files must retain the other files’ contributions.

## What It Does Not Prove

This examination does not run the suite. Passing behavior, deployed conformance and the behavior of substituted dependencies require separate execution evidence.

## Real Dependencies and Test Doubles

The local request harness exercises the route dispatcher and the prepared database. The suite controls the signing key at the declared seams; those collaborators remain outside its live proof.

## Must Not Be Doubled

Keep route dispatch, signed-context verification and the exercised service decisions real. A test key can supply signatures, but replacing the authorization decision cannot prove request enforcement.