{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://sebbi.pro/askwhy/ai-decisions.schema.json",
  "title": "Decision Rights file (ai-decisions.json), format ai-decisions/1",
  "description": "Published at /.well-known/ai-decisions.json. Declares the significant decisions an organisation makes about people by automated means, where requests about them go, how a person gets a human review, and how fast the organisation answers.",
  "type": "object",
  "required": [
    "format",
    "organisation",
    "rights_contact",
    "decisions"
  ],
  "properties": {
    "format": {
      "const": "ai-decisions/1"
    },
    "organisation": {
      "type": "string",
      "description": "Legal name of the organisation responsible for the decisions."
    },
    "rights_contact": {
      "type": "object",
      "description": "Where requests about automated decisions go.",
      "properties": {
        "email": {
          "type": "string",
          "format": "email"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "human_review": {
      "type": "object",
      "properties": {
        "how": {
          "type": "string"
        },
        "url": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "response_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "Days the organisation commits to answer within (the law allows one month)."
    },
    "decisions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "solely_automated",
          "significant"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "solely_automated": {
            "type": "boolean",
            "description": "No meaningful human involvement in taking the decision."
          },
          "significant": {
            "type": "boolean",
            "description": "Legal or similarly significant effect on the person."
          },
          "main_factors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The main kinds of information the decision rests on."
          },
          "human_review": {
            "type": "boolean",
            "description": "A person with authority to change the decision can review it on request."
          },
          "sealed_by": {
            "type": "string",
            "description": "Where each decision is sealed, e.g. sebbi.pro"
          }
        }
      }
    },
    "statement": {
      "type": "string"
    },
    "updated": {
      "type": "string",
      "format": "date"
    },
    "sebbi_askwhy_claim": {
      "type": "string",
      "description": "Optional. The claim code that verifies this domain's Ask Why inbox on sebbi.pro."
    }
  }
}