Submit a Core digest to one gate

product.gate.submit

Opens the approval that signs one gate on one Core digest, under the tenant's policy `core.gate.<gate>`. The call answers 202 approval_required with the approvalId and revisionHash, which binds the gate, the digest and the policy digest; the people the policy names decide it with approval.decide, and the maker never does. When the last step approves, the call runs once as the maker and answers with the signed gate and every decision. It refuses with core_digest_unknown when coreDigest is neither the Product's sandbox Core nor its live Core, gate_not_required when the tenant has no policy for the gate, gate_already_open or gate_already_signed when an approval on the same digest waits or signed, and, for SIT and UAT, gate_checks_failing while the stored check outcome for the digest has a failing check. A new digest has no approvals, so every gate opens again. Callers: the account owner's CLI login, or an agent token with products:write, or a personal access token with products:write.

POST /v1/products/{productId}/gates/{gate}

Principal user_session. Idempotency required. Environment sandbox.

Input

Output

Request sample

Only a signed-in person may call this: the CLI after hyperscale auth login, or curl with a personal access token (hyperscale_pat_...) with products:write or an agent token with products:write. The agent's grant must span every Product the call reads. A Product key cannot, so the SDK, which signs in with a Product key or a customer session, has no sample for it.

curl

curl --request POST 'https://hyperscale0.ai/v1/products/prd_sandbox_00000000000000000001/gates/sit' \
  --header "Authorization: Bearer $HYPERSCALE_TOKEN" \
  --header 'X-Hyperscale-Environment: sandbox' \
  --header "Idempotency-Key: $(uuidgen)" \
  --header 'Content-Type: application/json' \
  --data-raw '{"tenantId":"ten_sandbox_00000000000000000001","coreDigest":"3f2a9c41d7e8b65a0c1f4e2d9b8a7c6e5f4d3c2b1a09f8e7d6c5b4a39281706f"}'

CLI

hyperscale api call product.gate.submit \
  --input '{"gate":"sit","tenantId":"ten_sandbox_00000000000000000001","coreDigest":"3f2a9c41d7e8b65a0c1f4e2d9b8a7c6e5f4d3c2b1a09f8e7d6c5b4a39281706f"}'

Errors

All operations