Skip to main content
Version: main-dev

report.definition

Title: report.definition

Typeobject
Additional propertiesNot allowed

Description: Final report envelope produced by regis-cli, containing request metadata and analyzer results.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ versionNostring or nullNo-Version of regis-cli that generated this report.
- tierNostring or nullNo-The earned tier (e.g. Gold, Silver, Bronze) based on playbook conditions.
- badgesNoarray of objectNo--
- metadataNoobjectNo-Arbitrary user-provided metadata.
- linksNoarray of objectNo-Custom templated links.
+ requestNoobjectNo-Metadata describing the analysis request.
+ resultsNoobjectNo-Analyzer results keyed by analyzer name.
- playbooksNoarrayNo-List of evaluated playbook results.
- playbookNoobjectNoIn playbook_result.schema.jsonPrimary playbook result (shorthand for playbooks[0]).
- rulesNoarray of objectNo-List of unified rule results (promoted from playbooks[0]).
- rules_summaryNoobjectNo-Summary of rule evaluation results.

1. Required Property version

Typestring or null

Description: Version of regis-cli that generated this report.

2. Optional Property tier

Typestring or null

Description: The earned tier (e.g. Gold, Silver, Bronze) based on playbook conditions.

3. Optional Property badges

Typearray of object
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
badges items-

3.1. badges items

Typeobject
Additional propertiesAny type: allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
- slugNostringNo--
+ scopeNostringNo--
- valueNostring or nullNo--
+ classNoenum (of string)No--
- labelNostringNo--

3.1.1. Property slug

Typestring

3.1.2. Property scope

Typestring

3.1.3. Property value

Typestring or null

3.1.4. Property class

Typeenum (of string)

Must be one of:

  • "success"
  • "warning"
  • "error"
  • "information"

3.1.5. Property label

Typestring

4. Optional Property metadata

Typeobject
Additional propertiesAny type: allowed

Description: Arbitrary user-provided metadata.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- NoobjectNo--
Typearray of object

Description: Custom templated links.

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
links items-
Typeobject
Additional propertiesAny type: allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ labelNostringNo--
+ urlNostringNo--

5.1.1. Property label

Typestring

5.1.2. Property url

Typestring

6. Required Property request

Typeobject
Additional propertiesNot allowed

Description: Metadata describing the analysis request.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ urlNostringNo-Original URL or image reference provided by the user.
+ registryNostringNo-Resolved registry hostname (e.g. registry-1.docker.io).
+ repositoryNostringNo-Full repository path (e.g. library/nginx).
+ tagNostringNo-Image tag that was analyzed.
- digestNostringNo-Resolved image manifest digest (e.g. sha256-xxx), if available.
+ analyzersNoarray of stringNo-List of analyzer names that were executed.
+ timestampNostringNo-ISO 8601 UTC timestamp of the analysis.
- metadataNoobjectNo-Arbitrary user-provided metadata.

6.1. Required Property url

Typestring

Description: Original URL or image reference provided by the user.

6.2. Required Property registry

Typestring

Description: Resolved registry hostname (e.g. registry-1.docker.io).

6.3. Required Property repository

Typestring

Description: Full repository path (e.g. library/nginx).

6.4. Required Property tag

Typestring

Description: Image tag that was analyzed.

6.5. Optional Property digest

Typestring

Description: Resolved image manifest digest (e.g. sha256-xxx), if available.

6.6. Required Property analyzers

Typearray of string

Description: List of analyzer names that were executed.

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
analyzers items-

6.6.1. analyzers items

Typestring

6.7. Required Property timestamp

Typestring
Formatdate-time

Description: ISO 8601 UTC timestamp of the analysis.

6.8. Optional Property metadata

Typeobject
Additional propertiesAny type: allowed

Description: Arbitrary user-provided metadata.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- NoobjectNo--

7. Required Property results

Typeobject
Additional propertiesShould-conform

Description: Analyzer results keyed by analyzer name.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- NoobjectNo--

7.1. Property additionalProperties

Typeobject
Additional propertiesAny type: allowed

8. Optional Property playbooks

Typearray

Description: List of evaluated playbook results.

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
playbook_result.schema.json😅 ERROR in schema generation, a referenced schema could not be loaded, no documentation here unfortunately 🏜️

8.1. playbook_result.schema.json

Typeobject
Additional propertiesAny type: allowed
Defined inplaybook_result.schema.json

Description: 😅 ERROR in schema generation, a referenced schema could not be loaded, no documentation here unfortunately 🏜️

9. Optional Property playbook

Typeobject
Additional propertiesAny type: allowed
Defined inplaybook_result.schema.json

Description: Primary playbook result (shorthand for playbooks[0]).

10. Optional Property rules

Typearray of object

Description: List of unified rule results (promoted from playbooks[0]).

Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
rules items-

10.1. rules items

Typeobject
Additional propertiesAny type: allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ slugNostringNo--
+ titleNostringNo--
- levelNostringNo--
- tagsNoarray of stringNo--
+ passedNobooleanNo--
+ statusNoenum (of string)No--
+ messageNostringNo--
- analyzersNoarray of stringNo--

10.1.1. Property slug

Typestring

10.1.2. Property title

Typestring

10.1.3. Property level

Typestring

10.1.4. Property tags

Typearray of string
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
tags items-
10.1.4.1. tags items
Typestring

10.1.5. Property passed

Typeboolean

10.1.6. Property status

Typeenum (of string)

Must be one of:

  • "passed"
  • "failed"
  • "incomplete"

10.1.7. Property message

Typestring

10.1.8. Property analyzers

Typearray of string
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
analyzers items-
10.1.8.1. analyzers items
Typestring

11. Optional Property rules_summary

Typeobject
Additional propertiesAny type: allowed

Description: Summary of rule evaluation results.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
- scoreNointegerNo--
- totalNoarray of stringNo--
- passedNoarray of stringNo--
- by_tagNoobjectNo--

11.1. Optional Property score

Typeinteger
Restrictions
Minimum≥ 0
Maximum≤ 100

11.2. Optional Property total

Typearray of string
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
total items-

11.2.1. total items

Typestring

11.3. Optional Property passed

Typearray of string
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
passed items-

11.3.1. passed items

Typestring

11.4. Optional Property by_tag

Typeobject
Additional propertiesShould-conform
PropertyPatternTypeDeprecatedDefinitionTitle/Description
- NoobjectNo--

11.4.1. Property additionalProperties

Typeobject
Additional propertiesAny type: allowed
PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ rulesNoarray of stringNo--
+ passed_rulesNoarray of stringNo--
+ scoreNointegerNo--
11.4.1.1. Required Property rules
Typearray of string
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
rules items-
11.4.1.1.1. rules items
Typestring
11.4.1.2. Required Property passed_rules
Typearray of string
Array restrictions
Min itemsN/A
Max itemsN/A
Items unicityFalse
Additional itemsFalse
Tuple validationSee below
Each item of this array must beDescription
passed_rules items-
11.4.1.2.1. passed_rules items
Typestring
11.4.1.3. Required Property score
Typeinteger
Restrictions
Minimum≥ 0
Maximum≤ 100

Generated using json-schema-for-humans on 2026-03-21 at 11:43:39 +0000

  • 1. Required Property version
  • 2. Optional Property tier
  • 3. Optional Property badges
    • 3.1. badges items
  • 4. Optional Property metadata
  • 5. Optional Property links
    • 5.1. links items
  • 6. Required Property request
    • 6.1. Required Property url
    • 6.2. Required Property registry
    • 6.3. Required Property repository
    • 6.4. Required Property tag
    • 6.5. Optional Property digest
    • 6.6. Required Property analyzers
    • 6.7. Required Property timestamp
    • 6.8. Optional Property metadata
  • 7. Required Property results
    • 7.1. Property additionalProperties
  • 8. Optional Property playbooks
    • 8.1. playbook_result.schema.json
  • 9. Optional Property playbook
  • 10. Optional Property rules
    • 10.1. rules items
  • 11. Optional Property rules_summary
    • 11.1. Optional Property score
    • 11.2. Optional Property total
    • 11.3. Optional Property passed
    • 11.4. Optional Property by_tag