{
    "$schema": "http://json-schema.org/draft-04/schema#",
    "type": "object",
    "required": [
        "base_path",
        "details",
        "document_type",
        "publishing_app",
        "rendering_app",
        "routes",
        "schema_name",
        "title"
    ],
    "additionalProperties": false,
    "properties": {
        "access_limited": {
            "$ref": "#/definitions/access_limited"
        },
        "analytics_identifier": {
            "$ref": "#/definitions/analytics_identifier"
        },
        "auth_bypass_ids": {
            "description": "A list of ids that will allow access to this item for non-authenticated users",
            "$ref": "#/definitions/guid_list"
        },
        "base_path": {
            "$ref": "#/definitions/absolute_path"
        },
        "bulk_publishing": {
            "type": "boolean"
        },
        "change_note": {
            "type": [
                "null",
                "string"
            ]
        },
        "description": {
            "$ref": "#/definitions/description_optional"
        },
        "details": {
            "$ref": "#/definitions/details"
        },
        "document_type": {
            "type": "string",
            "enum": [
                "finder",
                "search"
            ]
        },
        "first_published_at": {
            "$ref": "#/definitions/first_published_at"
        },
        "last_edited_at": {
            "description": "Last time when the content received a major or minor update.",
            "type": "string",
            "format": "date-time"
        },
        "links": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "policy_areas": {
                    "description": "A largely deprecated tag currently only used to power email alerts.",
                    "$ref": "#/definitions/guid_list"
                }
            }
        },
        "locale": {
            "$ref": "#/definitions/locale"
        },
        "need_ids": {
            "type": "array",
            "items": {
                "type": "string"
            }
        },
        "phase": {
            "description": "The service design phase of this content item - https://www.gov.uk/service-manual/phases",
            "type": "string",
            "enum": [
                "alpha",
                "beta",
                "live"
            ]
        },
        "previous_version": {
            "type": "string"
        },
        "public_updated_at": {
            "$ref": "#/definitions/public_updated_at"
        },
        "publishing_app": {
            "$ref": "#/definitions/publishing_app_name"
        },
        "redirects": {
            "type": "array",
            "additionalItems": false,
            "items": {}
        },
        "rendering_app": {
            "$ref": "#/definitions/rendering_app"
        },
        "routes": {
            "$ref": "#/definitions/routes"
        },
        "schema_name": {
            "type": "string",
            "enum": [
                "finder"
            ]
        },
        "title": {
            "$ref": "#/definitions/title"
        },
        "update_type": {
            "$ref": "#/definitions/update_type"
        }
    },
    "definitions": {
        "description": {
            "type": "string"
        },
        "absolute_path": {
            "description": "A path only. Query string and/or fragment are not allowed.",
            "type": "string",
            "pattern": "^/(([a-zA-Z0-9._~!$&'()*+,;=:@-]|%[0-9a-fA-F]{2})+(/([a-zA-Z0-9._~!$&'()*+,;=:@-]|%[0-9a-fA-F]{2})*)*)?$"
        },
        "access_limited": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "auth_bypass_ids": {
                    "description": "Deprecated: auth_bypass_ids should be sent as a separate field",
                    "$ref": "#/definitions/guid_list"
                },
                "organisations": {
                    "description": "A list of organisation content ids permitted access to this item",
                    "$ref": "#/definitions/guid_list"
                },
                "users": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            }
        },
        "analytics_identifier": {
            "description": "A short identifier we send to Google Analytics for multi-valued fields. This means we avoid the truncated values we would get if we sent the path or slug of eg organisations.",
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ]
        },
        "description_optional": {
            "anyOf": [
                {
                    "$ref": "#/definitions/description"
                },
                {
                    "type": "null"
                }
            ]
        },
        "details": {
            "type": "object",
            "required": [
                "document_noun",
                "facets"
            ],
            "additionalProperties": false,
            "properties": {
                "beta": {
                    "$ref": "#/definitions/finder_beta"
                },
                "beta_message": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "null"
                        }
                    ]
                },
                "canonical_link": {
                    "type": "boolean"
                },
                "default_documents_per_page": {
                    "$ref": "#/definitions/finder_default_documents_per_page"
                },
                "default_order": {
                    "$ref": "#/definitions/finder_default_order"
                },
                "document_noun": {
                    "$ref": "#/definitions/finder_document_noun"
                },
                "facets": {
                    "$ref": "#/definitions/finder_facets"
                },
                "filter": {
                    "$ref": "#/definitions/finder_filter"
                },
                "format_name": {
                    "type": "string"
                },
                "generic_description": {
                    "type": "boolean"
                },
                "logo_path": {
                    "type": "string"
                },
                "no_index": {
                    "type": "boolean"
                },
                "reject": {
                    "$ref": "#/definitions/finder_reject_filter"
                },
                "show_summaries": {
                    "$ref": "#/definitions/finder_show_summaries"
                },
                "signup_link": {
                    "$ref": "#/definitions/finder_signup_link"
                },
                "sort": {
                    "$ref": "#/definitions/finder_sort"
                },
                "summary": {
                    "$ref": "#/definitions/finder_summary"
                }
            }
        },
        "finder_beta": {
            "description": "Indicates if finder is in beta. TODO: Switch to top-level phase label",
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "type": "null"
                }
            ]
        },
        "finder_default_documents_per_page": {
            "description": "Specify this to paginate results",
            "type": "integer"
        },
        "finder_default_order": {
            "description": "DEPRECATED: Use \u201csort\u201d property",
            "type": "string"
        },
        "finder_document_noun": {
            "description": "How to refer to documents when presenting the search results",
            "type": "string"
        },
        "finder_facets": {
            "description": "The facets shown to the user to refine their search.",
            "type": "array",
            "items": {
                "type": "object",
                "required": [
                    "key",
                    "filterable",
                    "display_as_result_metadata"
                ],
                "additionalProperties": false,
                "properties": {
                    "allowed_values": {
                        "description": "Possible values to show for non-dynamic select facets. All values are shown regardless of the search.",
                        "type": "array",
                        "items": {
                            "$ref": "#/definitions/label_value_pair"
                        }
                    },
                    "closed_value": {
                        "description": "Value that determines the closed state (the key field is in the past) of a topical facet.",
                        "$ref": "#/definitions/label_value_pair"
                    },
                    "combine_mode": {
                        "description": "Specifies how to combine with other facets",
                        "type": "string",
                        "default": "and",
                        "enum": [
                            "and",
                            "or"
                        ]
                    },
                    "display_as_result_metadata": {
                        "description": "Include this in search result metadata. Can be set for non-filterable facets.",
                        "type": "boolean"
                    },
                    "filter_key": {
                        "description": "The exact rummager field name for this facet. Allows 'key' to be aliased to a rummager filter field",
                        "type": "string"
                    },
                    "filter_value": {
                        "description": "A preset filter value that is applied when a checkbox is selected",
                        "type": "string"
                    },
                    "filterable": {
                        "description": "This must be true to show the facet to users.",
                        "type": "boolean"
                    },
                    "hide_facet_tag": {
                        "description": "Causes the facet to not have a facet tag shown in a finder",
                        "type": "boolean"
                    },
                    "key": {
                        "description": "The rummager field name used for this facet.",
                        "type": "string"
                    },
                    "keys": {
                        "description": "Field names used for the taxon drop down.",
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "name": {
                        "description": "Label for the facet.",
                        "type": "string"
                    },
                    "open_value": {
                        "description": "Value that determines the open state (the key field is in the future) of a topical facet.",
                        "$ref": "#/definitions/label_value_pair"
                    },
                    "option_lookup": {
                        "description": "A map of keys to values that can be used to associate allowed_values with multiple values",
                        "type": "object",
                        "additionalProperties": true,
                        "patternProperties": {
                            "^[a-z_]+$": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "preposition": {
                        "description": "Text used to augment the description of the search when the facet is used.",
                        "type": "string"
                    },
                    "short_name": {
                        "type": "string"
                    },
                    "show_option_select_filter": {
                        "description": "Controls whether Option Select Facet displays a filter field",
                        "type": "boolean"
                    },
                    "type": {
                        "description": "Defines the UI component and how the facet is queried from the search API",
                        "type": "string",
                        "enum": [
                            "autocomplete",
                            "checkbox",
                            "date",
                            "hidden",
                            "hidden_clearable",
                            "radio",
                            "research_and_statistics",
                            "official_documents",
                            "taxon",
                            "text",
                            "topical"
                        ]
                    }
                }
            }
        },
        "finder_filter": {
            "description": "This is the fixed filter that scopes the finder",
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "all_part_of_taxonomy_tree": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "content_purpose_subgroup": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "content_purpose_supergroup": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "content_store_document_type": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "document_type": {
                    "type": "string"
                },
                "email_document_supertype": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "facet_groups": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "format": {
                    "type": "string"
                },
                "has_official_document": {
                    "type": "boolean"
                },
                "organisations": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "policies": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            }
        },
        "finder_reject_filter": {
            "description": "A fixed filter that rejects documents which match the conditions",
            "type": "object",
            "additionalProperties": false,
            "properties": {
                "content_purpose_supergroup": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "content_store_document_type": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "email_document_supertype": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "link": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                },
                "policies": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    }
                }
            }
        },
        "finder_show_summaries": {
            "type": "boolean"
        },
        "finder_signup_link": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ]
        },
        "finder_sort": {
            "description": "These are the options for sorting the finder",
            "type": "array",
            "items": {
                "type": "object",
                "required": [
                    "key",
                    "name"
                ],
                "additionalProperties": false,
                "properties": {
                    "default": {
                        "description": "Indicates if this should be the default sort option",
                        "type": "boolean"
                    },
                    "key": {
                        "description": "Rummager field name, with an optional preceding \u201c-\u201d to sort in descending order",
                        "type": "string"
                    },
                    "name": {
                        "description": "Label for the sort option",
                        "type": "string"
                    }
                }
            }
        },
        "finder_summary": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "null"
                }
            ]
        },
        "first_published_at": {
            "description": "The date the content was first published.  Automatically determined by the publishing-api, unless overridden by the publishing application.",
            "type": "string",
            "format": "date-time"
        },
        "guid": {
            "type": "string",
            "pattern": "^[a-f0-9]{8}-[a-f0-9]{4}-[1-5][a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$"
        },
        "guid_list": {
            "type": "array",
            "items": {
                "$ref": "#/definitions/guid"
            },
            "_uniqueItems": true
        },
        "label_value_pair": {
            "description": "One of many possible values a user can select from",
            "type": "object",
            "required": [
                "label",
                "value"
            ],
            "additionalProperties": false,
            "properties": {
                "default": {
                    "description": "The default option for a radio facet",
                    "type": "boolean"
                },
                "label": {
                    "description": "A human readable label",
                    "type": "string"
                },
                "value": {
                    "description": "A value to use for form controls",
                    "type": "string"
                }
            }
        },
        "locale": {
            "type": "string",
            "enum": [
                "ar",
                "az",
                "be",
                "bg",
                "bn",
                "cs",
                "cy",
                "da",
                "de",
                "dr",
                "el",
                "en",
                "es",
                "es-419",
                "et",
                "fa",
                "fi",
                "fr",
                "gd",
                "he",
                "hi",
                "hr",
                "hu",
                "hy",
                "id",
                "is",
                "it",
                "ja",
                "ka",
                "kk",
                "ko",
                "lt",
                "lv",
                "ms",
                "mt",
                "nl",
                "no",
                "pl",
                "ps",
                "pt",
                "ro",
                "ru",
                "si",
                "sk",
                "sl",
                "so",
                "sq",
                "sr",
                "sv",
                "sw",
                "ta",
                "th",
                "tk",
                "tr",
                "uk",
                "ur",
                "uz",
                "vi",
                "zh",
                "zh-hk",
                "zh-tw"
            ]
        },
        "public_updated_at": {
            "description": "When the content was last significantly changed (a major update). Shown to users.  Automatically determined by the publishing-api, unless overridden by the publishing application.",
            "type": "string",
            "format": "date-time"
        },
        "publishing_app_name": {
            "description": "The application that published this item.",
            "type": "string",
            "enum": [
                "calculators",
                "calendars",
                "collections-publisher",
                "contacts",
                "content-publisher",
                "content-tagger",
                "email-alert-frontend",
                "external-link-tracker",
                "feedback",
                "frontend",
                "government-frontend",
                "hmrc-manuals-api",
                "info-frontend",
                "licencefinder",
                "local-links-manager",
                "manuals-frontend",
                "manuals-publisher",
                "maslow",
                "performanceplatform-big-screen-view",
                "publisher",
                "rummager",
                "search-admin",
                "search-api",
                "service-manual-publisher",
                "share-sale-publisher",
                "short-url-manager",
                "smartanswers",
                "special-route-publisher",
                "specialist-publisher",
                "static",
                "tariff",
                "travel-advice-publisher",
                "whitehall"
            ]
        },
        "rendering_app": {
            "description": "The application that renders this item.",
            "type": "string",
            "enum": [
                "calculators",
                "calendars",
                "collections",
                "content-store",
                "email-alert-frontend",
                "email-campaign-frontend",
                "feedback",
                "finder-frontend",
                "frontend",
                "government-frontend",
                "info-frontend",
                "licencefinder",
                "manuals-frontend",
                "performanceplatform-big-screen-view",
                "rummager",
                "search-api",
                "service-manual-frontend",
                "smartanswers",
                "spotlight",
                "static",
                "tariff",
                "whitehall-admin",
                "whitehall-frontend"
            ]
        },
        "route": {
            "type": "object",
            "required": [
                "path",
                "type"
            ],
            "additionalProperties": false,
            "properties": {
                "path": {
                    "type": "string"
                },
                "type": {
                    "enum": [
                        "prefix",
                        "exact"
                    ]
                }
            }
        },
        "routes": {
            "type": "array",
            "items": {
                "$ref": "#/definitions/route"
            },
            "minItems": 1
        },
        "title": {
            "type": "string"
        },
        "update_type": {
            "enum": [
                "major",
                "minor",
                "republish"
            ]
        }
    }
}