Write an approval policy

approval_policy.write

Publishes the next version of the tenant's approval policy under key. Every role a row names must be held by a member of the tenant, and no two rows may cover one amount: bands in one currency must not overlap, and a row with no band must stand alone. A program's `requires approval "<key>"` resolves the newest version when a call is admitted and pins its digest; calls already pending keep the version they pinned. The five Core gates are policies under `core.gate.<gate>`: writing one makes that gate required. A member with desk.settings.manage writes it from the console, or from their own CLI login (hyperscale auth login) in the sandbox only. An OAuth client with blueprints:write writes only core.gate.<gate> keys and is refused any other with oauth_client_not_admitted. A role no member holds refuses with approval_policy_invalid. Staff may write it for a tenant from the admin portal. Callers: the account owner's own CLI login (`hyperscale auth login`). An agent token is refused.

POST /v1/approval-policies/{key}

Principal user_session. Idempotency required. Environment either.

Input

Output

Request sample

Only a signed-in person may call this: the founder's own CLI after hyperscale auth login. 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/approval-policies/funding.release' \
  --header "Authorization: Bearer $HYPERSCALE_TOKEN" \
  --header 'X-Hyperscale-Environment: sandbox' \
  --header "Idempotency-Key: $(uuidgen)" \
  --header 'Content-Type: application/json' \
  --data-raw '{"rows":[{"by":["credit_officer"],"count":1,"band":{"currency":"SAR","below":"100000000"}},{"by":["credit_officer","credit_committee"],"count":2,"band":{"currency":"SAR","from":"100000000"}}]}'

CLI

hyperscale api call approval_policy.write \
  --input '{"key":"funding.release","rows":[{"by":["credit_officer"],"count":1,"band":{"currency":"SAR","below":"100000000"}},{"by":["credit_officer","credit_committee"],"count":2,"band":{"currency":"SAR","from":"100000000"}}]}'

Errors

All operations