{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/confighub/json-schema/confighub-attest-result-schema.json",
  "title": "AttestResult",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/confighub-attest-api-openapi.yml#/components/schemas/AttestResult",
  "type": "object",
  "properties": {
    "Spaces": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/AttestSpaceResult"
      },
      "x-go-type-skip-optional-pointer": true
    }
  },
  "$defs": {
    "AttestSpaceResult": {
      "type": "object",
      "properties": {
        "Attestation": {
          "$ref": "#/$defs/Attestation"
        },
        "Error": {
          "$ref": "#/$defs/ResponseError"
        },
        "SkippedUnits": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/AttestationSkippedUnit"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "SpaceID": {
          "type": "string",
          "format": "uuid",
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "SpaceSlug": {
          "type": "string",
          "x-go-type-skip-optional-pointer": true
        },
        "Subjects": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/AttestationSubject"
          },
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "Attestation": {
      "type": "object",
      "properties": {
        "AttestationID": {
          "type": "string",
          "description": "Uniquely identifies the Attestation.",
          "format": "uuid",
          "x-confighub-where": {
            "dataType": "uuid"
          },
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "ChangeOrderID": {
          "type": "string",
          "description": "The ChangeOrder the Attestation was made in the context of. Context only: it does not change which Revisions are covered.",
          "format": "uuid",
          "x-confighub-where": {
            "dataType": "uuid",
            "references": "ChangeOrder"
          }
        },
        "Claims": {
          "type": "object",
          "additionalProperties": {
            "type": "string"
          },
          "description": "Anything else the attester records, as string key/value pairs with the limits of Annotations.",
          "x-confighub-where": {
            "dataType": "map[string]string"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "CreatedAt": {
          "type": "string",
          "description": "The timestamp when the entity was created in \"2023-01-01T12:00:00Z\" format.",
          "format": "date-time",
          "readOnly": true,
          "x-confighub-where": {
            "dataType": "time"
          },
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "EntityType": {
          "type": "string",
          "description": "The type of entity.",
          "readOnly": true,
          "x-go-type-skip-optional-pointer": true
        },
        "EvidenceAttestationIDs": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/UUID"
          },
          "description": "Other Attestations this one relied on. They may be in other Spaces.",
          "x-confighub-where": {
            "dataType": "[]uuid",
            "references": "Attestation"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "ExpiresAt": {
          "type": "string",
          "description": "When the Attestation stops satisfying requirements. Optional.",
          "format": "date-time",
          "x-confighub-where": {
            "dataType": "time"
          },
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "Hash": {
          "type": "string",
          "description": "SHA256 hash of the claim encoded as hexadecimal: the statement (Type, Result, RevokedAttestationID, ChangeOrderID, ReleaseID, EvidenceAttestationIDs, Note, Claims and ExpiresAt), the User who recorded it, and the Revisions it covers. (readonly)",
          "readOnly": true,
          "x-confighub-where": {
            "dataType": "string"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "HiddenReason": {
          "type": "string",
          "description": "The reason the entity is hidden, if it is. A hidden entity is left out of List and Search results, and of what bulk operations act on, unless the include_hidden parameter names its reason or is *, or the where parameter names the entity by Slug or ID. ConfigHub/YAML Units are created hidden with the reason BackingUnit unless given another.",
          "x-confighub-where": {
            "dataType": "string"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "Note": {
          "type": "string",
          "description": "The attester's reason, in their own words.",
          "x-confighub-where": {
            "dataType": "string"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "OrganizationID": {
          "type": "string",
          "description": "The Organization the Attestation belongs to.",
          "format": "uuid",
          "x-confighub-where": {
            "dataType": "uuid",
            "references": "Organization",
            "expandable": true
          },
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "Permissions": {
          "allOf": [
            {
              "$ref": "#/$defs/Permissions"
            }
          ],
          "description": "Permissions to access this attestation.",
          "x-confighub-where": {
            "dataType": "map[string]map[string]map[uuid]bool"
          }
        },
        "ReleaseID": {
          "type": "string",
          "description": "A published Release the claim is about.",
          "format": "uuid",
          "x-confighub-where": {
            "dataType": "uuid",
            "references": "Release"
          }
        },
        "Result": {
          "enum": [
            "Pass",
            "Fail"
          ],
          "type": "string",
          "description": "The outcome: Pass or Fail. For an Approval, approve or reject. Defaults to Pass.",
          "x-confighub-where": {
            "dataType": "string"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "RevokedAttestationID": {
          "type": "string",
          "description": "An earlier Attestation in the same Space that this one withdraws. A revocation covers no Revisions of its own.",
          "format": "uuid",
          "x-confighub-where": {
            "dataType": "uuid",
            "references": "Attestation"
          }
        },
        "SpaceID": {
          "type": "string",
          "description": "The Space the Attestation belongs to. Every Revision it covers is in this Space.",
          "format": "uuid",
          "x-confighub-where": {
            "dataType": "uuid",
            "references": "Space",
            "expandable": true
          },
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "SpaceSlug": {
          "type": "string",
          "description": "Slug of the Space the Attestation belongs to.",
          "readOnly": true,
          "x-go-type-skip-optional-pointer": true
        },
        "Type": {
          "type": "string",
          "description": "What is being claimed, such as Approval. Requirements select Attestations by it. Defaults to Approval.",
          "x-confighub-where": {
            "dataType": "string"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "UpdatedAt": {
          "type": "string",
          "description": "The timestamp when the entity was last updated in \"2023-01-01T12:00:00Z\" format.",
          "format": "date-time",
          "readOnly": true,
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "UserID": {
          "type": "string",
          "description": "The authenticated User that created the Attestation.",
          "format": "uuid",
          "readOnly": true,
          "x-confighub-where": {
            "dataType": "uuid",
            "references": "User"
          },
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "Version": {
          "type": "integer",
          "description": "An entity-specific sequence number used for optimistic concurrency control. The value read must be sent in calls to Update.",
          "format": "int64",
          "readOnly": false,
          "x-go-type-skip-optional-pointer": true
        }
      },
      "description": "An Attestation records that a principal made a claim about specific Revisions, all in its Space: that they approve them, that a review or check passed or failed, or anything else its Type names. It is never updated; withdrawing one is a new Attestation naming it in RevokedAttestationID."
    },
    "AttestationSkippedUnit": {
      "type": "object",
      "properties": {
        "Message": {
          "type": "string",
          "description": "Why the Unit is not covered, in words.",
          "x-go-type-skip-optional-pointer": true
        },
        "Reason": {
          "type": "string",
          "description": "Why the Unit is not covered, as a code: NoTarget or NoRevision.",
          "x-go-type-skip-optional-pointer": true
        },
        "UnitID": {
          "type": "string",
          "format": "uuid",
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "UnitSlug": {
          "type": "string",
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "AttestationSubject": {
      "type": "object",
      "properties": {
        "Authored": {
          "type": "boolean",
          "description": "With a ChangeOrder, the caller wrote one of the Revisions of the change on this Unit in this Space, so the Attestation does not count here for a prerequisite that excludes authors.",
          "x-go-type-skip-optional-pointer": true
        },
        "RevisionID": {
          "type": "string",
          "format": "uuid",
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "RevisionNum": {
          "type": "integer",
          "format": "int64",
          "x-go-type-skip-optional-pointer": true
        },
        "UnitID": {
          "type": "string",
          "format": "uuid",
          "x-go-type-skip-optional-pointer": true,
          "x-omitzero": true
        },
        "UnitSlug": {
          "type": "string",
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "ErrorItem": {
      "type": "object",
      "properties": {
        "Description": {
          "type": "string",
          "description": "A clear explanation of what went wrong",
          "x-go-type-skip-optional-pointer": true
        },
        "Item": {
          "type": "string",
          "description": "The name of the field, resource, or entity that the error relates to",
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "ErrorMetadata": {
      "type": "object",
      "properties": {
        "EntityID": {
          "type": "string",
          "description": "Optional ID of the entity this error relates to",
          "x-go-type-skip-optional-pointer": true
        },
        "EntitySlug": {
          "type": "string",
          "description": "Optional slug of the entity this error relates to",
          "x-go-type-skip-optional-pointer": true
        },
        "EntityType": {
          "type": "string",
          "description": "Optional type of the entity this error relates to",
          "x-go-type-skip-optional-pointer": true
        },
        "Items": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ErrorItem"
          },
          "description": "Collection of error details",
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "Permissions": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/$defs/Subjects"
      }
    },
    "ResponseError": {
      "type": "object",
      "properties": {
        "Details": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Additional context messages",
          "x-go-type-skip-optional-pointer": true
        },
        "ErrorMetadata": {
          "allOf": [
            {
              "$ref": "#/$defs/ErrorMetadata"
            }
          ],
          "description": "Structured error details like field violations"
        },
        "Message": {
          "type": "string",
          "description": "The primary error message",
          "x-go-type-skip-optional-pointer": true
        },
        "Status": {
          "type": "integer",
          "description": "HTTP status code",
          "x-go-type-skip-optional-pointer": true
        },
        "Type": {
          "type": "string",
          "description": "The category of the error, as a code: UserInput, Validation, Data, Authentication, Permission, NotFound, Conflict, AlreadyExists, Unprocessable, Locked, PreconditionFailed, TooManyRequests, Unexpected, GatewayTimeout, or ServiceUnavailable",
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "Subjects": {
      "type": "object",
      "properties": {
        "GroupIDs": {
          "type": "object",
          "additionalProperties": {
            "type": "boolean"
          },
          "x-go-type-skip-optional-pointer": true
        },
        "UserIDs": {
          "type": "object",
          "additionalProperties": {
            "type": "boolean"
          },
          "x-go-type-skip-optional-pointer": true
        }
      }
    },
    "UUID": {
      "type": "string",
      "format": "uuid"
    }
  }
}