Skip to content

verdict policy get

Retrieve exact published policy source, preserving comments and whitespace. Use —json for an object containing source.

Runs against the selected server connection. Effects: read server state.

ArgumentTypeRequiredDefaultDescription
--jsonbooleannofalseOutput as JSON
--endpointstringnoNo parser defaultInstance base URL, including any subpath (env: VERDICT_HOST, fallback: http://localhost:4891)
--hoststringnoNo parser defaultAlias for —endpoint
--api-keystringnoNo parser defaultAPI key (env: VERDICT_API_KEY takes precedence)
--profilestringnoNo parser defaultStored profile (env: VERDICT_PROFILE)
--localbooleannofalseUse http://localhost:4891 without stored or environment credentials

--help (-h) shows command help without executing the command. Boolean flags support --no-<flag>. Defaults stated in descriptions may be resolved by the handler or configuration rather than the argument parser.

Command arguments and flags; stdin is unsupported.

File input: unsupported. Standard input: unsupported.

{
"kind": "json-schema",
"schema": {
"type": "object",
"properties": {
"source": {
"type": "string"
}
},
"required": [
"source"
],
"additionalProperties": false
},
"example": {
"source": "allow(User:alice, \"read\", Document:handbook);"
}
}

By default, the command renders human-readable records. --json writes one JSON result to stdout. Operational failures use status 1; JSON failures contain an error object with code and message. See shared output semantics.

  • 0: the selected policy content was printed.
  • 1: retrieval failed, arguments were invalid, or policy source is unavailable. Republish the policy to retain its source.

Argument, I/O, and other failures handled by the CLI runner use status 1.

verdict policy get
verdict policy get > policy.vd
verdict policy get --json