Skip to content

uc-apx edit authorization

Rewrite an existing top-level authorization scheme without rescaffolding it.

Only the flags you pass are touched; unrelated blocks (e.g. advanced) are preserved. The settings block is rewritten only when —type, —body, or —names is passed. Supported —type values mirror create authorization: plSqlFunctionBody / plSqlExpression / existsSqlQuery / notExistsSqlQuery → —body isInRoleOrGroup / isNotInRoleOrGroup → —names

Changing —type across shapes (body ↔ roles) requires the matching payload flag, since the old settings can’t be reinterpreted.

uc-apx edit authorization [flags]
FlagTypeDefaultDescription
--bodystringNew PL/SQL or SQL body for body-shape types (or @path/to/file; @@ escapes a literal leading @)
--dry-runPrint the rewritten file content to stdout without writing
--error-messagestringSet error.errorMessage; pass "" to remove the error block
--idstringId of the authorization scheme to edit [required]
--namestringNew display name
--namesstringsNew role/group name(s) for isInRoleOrGroup variants (repeatable, replaces existing)
--typestringNew authorization type (see help)
FlagTypeDefaultDescription
--app-dirstring.Path to the APEX application directory
--json-prettyOutput in pretty-printed JSON (human-readable) instead of minified JSON
--toonOutput in TOON format (human-readable, token-efficient) instead of JSON