openapi.json

{
    "openapi": "3.1.0",
    "info": {
        "title": "HotCRP REST API",
        "version": "2024-12-09:74fb3c4fc",
        "summary": "HotCRP conference management software API",
        "description": "[HotCRP](https://github.com/kohler/hotcrp) is conference review software. It\nis open source; a supported version runs on [hotcrp.com](https://hotcrp.com/).\nThis documentation is for the HotCRP REST-like API.\n\nTo request documentation for an API method, please open a [GitHub\nissue](https://github.com/kohler/hotcrp/issues). We also welcome [pull\nrequests](https://github.com/kohler/hotcrp/pulls).\n\n\n## Overview\n\nHotCRP parameters are generally provided using [form\nencoding](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods/POST),\neither in query strings or in the request body. Some parameters are formatted\nas JSON. Complex requests generally use structured keys, such as\n`named_search/1/q`. Use `multipart/form-data`\nfor requests that include uploaded files.\n\nThe common `p` parameter defines a submission ID. It can appear either in the\nquery string or immediately following `api/` in the query path:\n`api/comment?p=1` and `api/1/comment` are the same API call. `p` is a positive\ndecimal integer, but some API calls accept `p=new` when defining a new\nsubmission.\n\nResponses are formatted as JSON. Every response has an `ok` property; `ok` is\n`true` if the request succeeded and `false` otherwise. Messages about the\nrequest, if any, are expressed in a `message_list` property.\n\nThe `GET` method is used to retrieve information and the `POST` method to\nmodify information. Other methods are generally not used; for instance,\ndeleting a comment uses a `delete=1` parameter for a `POST` request, rather\nthan a `DELETE` request.\n\n\n### Authentication\n\nExternal applications should authenticate to HotCRP’s API using bearer tokens\n(an `Authorization: bearer` HTTP header). Obtain an API token using Account\nsettings > Developer.\n\nHotCRP Javascript makes API calls using session cookies for authentication.\n"
    },
    "paths": {
        "/paper": {
            "get": {
                "summary": "Retrieve submission",
                "description": "This endpoint retrieves JSON-formatted information about a submission. All\nvisible information about submission fields, tags, and overall status are\nreturned in as the response’s `paper` property. Error messages—for instance,\nabout permission errors or nonexistent submissions—are returned in\n`message_list`.\n\nThe returned `paper` property is a submission object. Submission objects are\nformatted based on the submission form. Every paper object has an `object`\nproperty set to `\"paper\"`, a `pid`, and a `status`. Other properties are\nprovided based on which submission fields exist and whether the accessing user\ncan see them.\n",
                "tags": [
                    "Submissions"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "name": "forceShow",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "False to not override administrator conflict"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "paper": {
                                                    "$ref": "#/components/schemas/paper"
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Create or modify submission",
                "description": "This endpoint modifies the submission specified by the `p` parameter. Setting\n`p=new` will create a new submission; the response will contain the chosen\nsubmission ID.\n\nModifications are specified using a JSON object. There are three ways to\nprovide that JSON, depending on the content-type of the request:\n\n1. As a JSON request body with content-type `application/json`.\n2. In a ZIP archive request body with content-type `application/zip`, as a\n   file named `data.json`.\n3. As a parameter named `json` in a normal `application/x-www-form-urlencoded`\n   or `multipart/form-data` body.\n\nHowever it is provided, the JSON must define an object interpretable as a\nsubmission (or a subset of a submission). The properties of this object define\nthe modifications to be applied to the submission.\n\nThe `p` parameter is optional; if unset, HotCRP uses the `pid` from the\nsupplied JSON. If the `p` parameter and the JSON `pid` property are both\npresent, then they must match.\n\nTo test a modification, supply a `dry_run=1` parameter. This will test the\nuploaded JSON but make no changes to the database.\n\n\n### ZIP and form uploads\n\nA ZIP upload should contain a file named `data.json` (`PREFIX-data.json` is\nalso acceptable). This file’s content is parsed as JSON. Submission fields in\nthe JSON can refer to other files in the ZIP. For instance, this shell session\nuploads a new submission with content `paper.pdf`:\n\n```\n$ cat data.json\n{\n\t\"object\": \"paper\",\n\t\"pid\": \"new\",\n\t\"title\": \"Aught: A Methodology for the Visualization of Scheme\",\n\t\"authors\": [{\"name\": \"Nevaeh Gomez\", \"email\": \"ngomez@example.edu\"}],\n\t\"submission\": {\"content_file\": \"paper.pdf\"},\n\t\"status\": \"submitted\"\n}\n$ zip upload.zip data.json paper.pdf\n$ curl -H \"Authorization: bearer hct_XXX\" --data-binary @upload.zip -H \"Content-Type: application/zip\" SITEURL/api/paper\n```\n\nThis shell session does the same, but using `multipart/form-data`.\n\n```\n$ curl -H \"Authorization: bearer hct_XXX\" -F \"json=<data.json\" -F paper.pdf=@paper.pdf SITEURL/api/paper\n```\n\n### Responses\n\nIf the modification succeeds, the response’s `paper` property contains the\nmodified submission object.\n\nThe `change_list` property is a list of names of the modified fields. New\nsubmissions have `\"pid\"` as the first item in the list. `change_list` contains\nfields that the request *attempted* to modify; successful requests, erroneous\nrequests, and dry-run requests can all return nonempty `change_list`s.\n\nThe `valid` property is `true` if and only if the modification was valid. In\nnon-dry-run requests, `valid: true` indicates that database changes were\ncommitted.\n\nDry-run requests return `change_list` and `valid` properties, but not `paper`\nproperties, since no modifications are performed.\n\n\n### Administrator use\n\nAdministrators can use this endpoint to set some submission properties, such\nas `decision`, that have other endpoints as well.\n\nAdministrators can choose specific IDs for new submissions; just set `p` (or\nJSON `pid`) to the chosen ID. Such a request will either modify an existing\nsubmission or create a new submission with that ID. To avoid overwriting an\nexisting submission, set the JSON’s `status`.`if_unmodified_since` to `0`.\n",
                "tags": [
                    "Submissions"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "True checks input for errors, but does not save changes"
                    },
                    {
                        "name": "disable_users",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "True disables any newly-created users (administrators only)"
                    },
                    {
                        "name": "add_topics",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "True automatically adds topics from input papers (administrators only)"
                    },
                    {
                        "name": "notify",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "False does not notify contacts of changes (administrators only)"
                    },
                    {
                        "$ref": "#/components/parameters/forceShow"
                    },
                    {
                        "name": "json",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "paper": {
                                                    "$ref": "#/components/schemas/paper",
                                                    "description": "JSON version of modified paper"
                                                },
                                                "dry_run": {
                                                    "type": "boolean",
                                                    "description": "True for `dry_run` requests"
                                                },
                                                "change_list": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "string"
                                                    },
                                                    "description": "List of changed fields"
                                                },
                                                "valid": {
                                                    "type": "boolean",
                                                    "description": "True if the modification was valid"
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/papers": {
            "get": {
                "summary": "Retrieve multiple submissions",
                "description": "This endpoint retrieves JSON-formatted information about multiple submissions\nbased on a search. The search is specified in the `q` parameter; all matching\nvisible papers are returned. Other search parameters (`t`, `qt`) are accepted\ntoo. The response property `papers` is an array of matching submission objects.\n\nSince searches silently filter out non-viewable submissions, `/papers?q=1010`\nand `/paper?p=1010` can return different error messages. The `/paper` request\nmight return an error like `Submission #1010 does not exist` or `You aren’t\nallowed to view submission #10110`, whereas the `/papers` request will return\nno errors. To obtain warnings for missing submissions that were explicitly\nlisted in a query, supply a `warn_missing=1` parameter.\n",
                "tags": [
                    "Submissions"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/t"
                    },
                    {
                        "$ref": "#/components/parameters/qt"
                    },
                    {
                        "$ref": "#/components/parameters/scoresort"
                    },
                    {
                        "$ref": "#/components/parameters/sort"
                    },
                    {
                        "$ref": "#/components/parameters/reviewer"
                    },
                    {
                        "name": "warn_missing",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "Get warnings for missing submissions"
                    },
                    {
                        "$ref": "#/components/parameters/forceShow"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "papers": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/paper"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Create or modify multiple submissions",
                "description": "This administrator-only endpoint modifies multiple submissions at once. Its\nrequest formats are similar to that of `POST /{p}/paper`: it can accept a\nJSON, ZIP, or form-encoded request body with a `json` parameter, and ZIP and\nform-encoded requests can also include attached files.\n\nThe JSON provided for `/papers` should be an *array* of JSON objects. Response\nproperties `papers`, `change_lists`, and `valid` are arrays with the same\nnumber of elements as the input JSON; component *i* of each response property\ncontains the result for the *i*th submission object in the input JSON.\n\nAlternately, you can provide a `q` search query parameter and a *single* JSON\nobject. The JSON object must not have a `pid` property. The JSON modification\nwill be applied to all papers returned by the `q` search query.\n\nThe response `message_list` contains messages relating to all modified\nsubmissions. To filter out the messages for a single submission, use the\nmessages’ `landmark` properties. `landmark` is set to the integer index of the\nrelevant submission in the input JSON.\n\n",
                "tags": [
                    "Submissions"
                ],
                "parameters": [
                    {
                        "name": "json",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "True checks input for errors, but does not save changes"
                    },
                    {
                        "name": "disable_users",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "True disables any newly-created users (administrators only)"
                    },
                    {
                        "name": "add_topics",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "True automatically adds topics from input papers (administrators only)"
                    },
                    {
                        "name": "notify",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "False does not notify contacts of changes (administrators only)"
                    },
                    {
                        "$ref": "#/components/parameters/forceShow"
                    },
                    {
                        "name": "q",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/search_string"
                        },
                        "description": "Search query for match requests"
                    },
                    {
                        "name": "t",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/search_collection"
                        },
                        "description": "Collection to search; defaults to `viewable`"
                    },
                    {
                        "$ref": "#/components/parameters/qt"
                    },
                    {
                        "$ref": "#/components/parameters/sort"
                    },
                    {
                        "$ref": "#/components/parameters/scoresort"
                    },
                    {
                        "$ref": "#/components/parameters/reviewer"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "papers": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/paper"
                                                    },
                                                    "description": "List of JSON versions of modified papers"
                                                },
                                                "dry_run": {
                                                    "type": "boolean",
                                                    "description": "True for `dry_run` requests"
                                                },
                                                "change_lists": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "array",
                                                        "items": {
                                                            "type": "string"
                                                        }
                                                    },
                                                    "description": "List of lists of changed fields"
                                                },
                                                "valid": {
                                                    "type": "array",
                                                    "items": {
                                                        "type": "boolean"
                                                    },
                                                    "description": "List of validity checks"
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/formatcheck": {
            "get": {
                "summary": "Check PDF format",
                "tags": [
                    "Documents"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "name": "doc",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/document_name"
                        }
                    },
                    {
                        "name": "soft",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "dt",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/document_type"
                        }
                    },
                    {
                        "name": "docid",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/document_id"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "npages",
                                                "nwords",
                                                "problem_fields",
                                                "has_error",
                                                "docid"
                                            ],
                                            "properties": {
                                                "npages": {},
                                                "nwords": {},
                                                "problem_fields": {},
                                                "has_error": {},
                                                "docid": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/upload": {
            "post": {
                "summary": "Upload file",
                "description": "The `POST /upload` endpoint uploads documents to the server. It is intended\nfor large documents, and can upload a file over multiple requests, each\ncontaining a slice of the data.\n\nTo start an upload, set `start=1` and include the `size` of the whole uploaded\nfile. The response will include a `token` field, a string like\n`hcupwhvGDVmHNYyDKdqeqA` that identifies the upload in progress. All further\nrequests for the upload must include the `token` as parameter.\n\nEach request adds a chunk of data to the upload. The `offset` parameter gives\nthe byte offset of the uploaded chunk; the `blob` attachment parameter\ncontains the chunk itself. The request that completes the upload should set\n`finish=1`; this request will fail unless all chunks have been received.\n\nThe `ranges` response field represents the ranges of bytes received so far.\nThe response to a `finish=1` request will include a `hash` field, which is the\nhash of the uploaded document.\n\nThe upload API is only available on sites that have enabled the document\nstore.\n",
                "tags": [
                    "Documents"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "name": "dtype",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/document_type"
                        }
                    },
                    {
                        "name": "start",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "offset",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 0
                        },
                        "description": "Offset of `blob` in uploaded file"
                    },
                    {
                        "name": "size",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "integer",
                            "minimum": 0
                        },
                        "description": "Size of uploaded file"
                    },
                    {
                        "name": "finish",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "token",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/upload_token"
                        }
                    },
                    {
                        "name": "cancel",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "multipart/form-data": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "mimetype": {
                                        "$ref": "#/components/schemas/mimetype"
                                    },
                                    "filename": {
                                        "type": "string"
                                    },
                                    "blob": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "token"
                                            ],
                                            "properties": {
                                                "token": {
                                                    "$ref": "#/components/schemas/upload_token"
                                                },
                                                "dtype": {
                                                    "$ref": "#/components/schemas/document_type"
                                                },
                                                "filename": {
                                                    "type": "string"
                                                },
                                                "mimetype": {
                                                    "$ref": "#/components/schemas/mimetype"
                                                },
                                                "size": {
                                                    "type": "integer",
                                                    "minimum": 0
                                                },
                                                "ranges": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/offset_range"
                                                    }
                                                },
                                                "hash": {
                                                    "type": "string"
                                                },
                                                "server_progress_loaded": {
                                                    "type": "integer"
                                                },
                                                "server_progress_max": {
                                                    "type": "integer"
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/assign": {
            "post": {
                "summary": "Assignments",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "$ref": "#/components/parameters/redirect"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "assignments"
                                ],
                                "properties": {
                                    "assignments": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/decision": {
            "get": {
                "summary": "Retrieve submission decision",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "decision",
                                                "decision_html"
                                            ],
                                            "properties": {
                                                "decision": {},
                                                "decision_html": {},
                                                "editable": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Change submission decision",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "decision"
                                ],
                                "properties": {
                                    "decision": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "decision",
                                                "decision_html"
                                            ],
                                            "properties": {
                                                "decision": {},
                                                "decision_html": {},
                                                "editable": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/lead": {
            "get": {
                "summary": "Retrieve submission discussion lead",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "lead",
                                                "lead_html"
                                            ],
                                            "properties": {
                                                "lead": {},
                                                "lead_html": {},
                                                "color_classes": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Change submission discussion lead",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "lead"
                                ],
                                "properties": {
                                    "lead": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "lead",
                                                "lead_html"
                                            ],
                                            "properties": {
                                                "lead": {},
                                                "lead_html": {},
                                                "color_classes": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/manager": {
            "get": {
                "summary": "Retrieve submission administrator",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "manager",
                                                "manager_html"
                                            ],
                                            "properties": {
                                                "manager": {},
                                                "manager_html": {},
                                                "color_classes": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Change submission administrator",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "manager"
                                ],
                                "properties": {
                                    "manager": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "manager",
                                                "manager_html"
                                            ],
                                            "properties": {
                                                "manager": {},
                                                "manager_html": {},
                                                "color_classes": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/reviewround": {
            "post": {
                "summary": "Change review round",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/shepherd": {
            "get": {
                "summary": "Retrieve submission shepherd",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "shepherd",
                                                "shepherd_html"
                                            ],
                                            "properties": {
                                                "shepherd": {},
                                                "shepherd_html": {},
                                                "color_classes": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Change submission shepherd",
                "tags": [
                    "Submission administration"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "shepherd"
                                ],
                                "properties": {
                                    "shepherd": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "shepherd",
                                                "shepherd_html"
                                            ],
                                            "properties": {
                                                "shepherd": {},
                                                "shepherd_html": {},
                                                "color_classes": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/search": {
            "get": {
                "summary": "Retrieve search results",
                "description": "Use this endpoint to return the list of submission IDs corresponding to a\nsearch.\n\nPass the search query in the `q` parameter. The list of matching IDs is\nreturned in the `ids` response property.\n\nThe `t`, `qt`, `reviewer`, `sort`, and `scoresort` parameters can also affect\nthe search. `t` defines the collection of submissions to search. `t=viewable`\nchecks all submissions the user can view; the default collection is often\nnarrower (a typical default is `t=s`, which searches complete submissions).\n\nThe `groups` response property is an array of annotations that apply to the\nsearch, and is returned for `THEN` searches, `LEGEND` searches, and searches\non tags with annotations. Each annotation contains a position `pos`, and may\nalso have a `legend`, a `search`, an `annoid`, and other properties. `pos` is\nan integer index into the `ids` array; it ranges from 0 to the number of items\nin that array. Annotations with a given `pos` should appear *before* the paper\nat that index in the `ids` array. For instance, this response might be\nreturned for the search `10-12 THEN 15-18`:\n\n```json\n{\n    \"ok\": true,\n    \"message_list\": [],\n    \"ids\": [10, 12, 18],\n    \"groups\": [\n        {\n            \"pos\": 0,\n            \"legend\": \"10-12\",\n            \"search\": \"10-12\"\n        },\n        {\n            \"pos\": 2,\n            \"legend\": \"15-18\",\n            \"search\": \"15-18\"\n        }\n    ]\n}\n```\n",
                "tags": [
                    "Search"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/t"
                    },
                    {
                        "$ref": "#/components/parameters/qt"
                    },
                    {
                        "$ref": "#/components/parameters/sort"
                    },
                    {
                        "$ref": "#/components/parameters/scoresort"
                    },
                    {
                        "$ref": "#/components/parameters/reviewer"
                    },
                    {
                        "name": "report",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "warn_missing",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/search_response"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/fieldhtml": {
            "get": {
                "summary": "Retrieve search results as field HTML",
                "tags": [
                    "Search"
                ],
                "parameters": [
                    {
                        "name": "f",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    },
                    {
                        "name": "aufull",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "session",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/t"
                    },
                    {
                        "$ref": "#/components/parameters/qt"
                    },
                    {
                        "$ref": "#/components/parameters/reviewer"
                    },
                    {
                        "$ref": "#/components/parameters/sort"
                    },
                    {
                        "$ref": "#/components/parameters/scoresort"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "fields",
                                                "data"
                                            ],
                                            "properties": {
                                                "fields": {},
                                                "data": {},
                                                "stat": {},
                                                "classes": {},
                                                "attr": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/fieldtext": {
            "get": {
                "summary": "Retrieve list field text",
                "tags": [
                    "Search"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/searchactions": {
            "get": {
                "summary": "Retrieve available search actions",
                "tags": [
                    "Search"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "actions"
                                            ],
                                            "properties": {
                                                "actions": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/searchaction": {
            "get": {
                "summary": "Perform search action",
                "tags": [
                    "Search"
                ],
                "parameters": [
                    {
                        "name": "action",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/q"
                    },
                    {
                        "$ref": "#/components/parameters/t"
                    },
                    {
                        "$ref": "#/components/parameters/qt"
                    },
                    {
                        "$ref": "#/components/parameters/sort"
                    },
                    {
                        "name": "report",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/scoresort"
                    },
                    {
                        "$ref": "#/components/parameters/reviewer"
                    },
                    {
                        "$ref": "#/components/parameters/p.opt"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/graphdata": {
            "get": {
                "tags": [
                    "Search"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/namedsearch": {
            "get": {
                "tags": [
                    "Search"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "searches"
                                            ],
                                            "properties": {
                                                "searches": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Search"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "searches"
                                            ],
                                            "properties": {
                                                "searches": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/searchcompletion": {
            "get": {
                "tags": [
                    "Search"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "searchcompletion"
                                            ],
                                            "properties": {
                                                "searchcompletion": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/viewoptions": {
            "get": {
                "tags": [
                    "Search"
                ],
                "parameters": [
                    {
                        "name": "report",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/q.opt"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "report",
                                                "display_current",
                                                "display_default",
                                                "display_difference",
                                                "display_default_message_list"
                                            ],
                                            "properties": {
                                                "report": {},
                                                "display_current": {},
                                                "display_default": {},
                                                "display_difference": {},
                                                "display_default_message_list": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Search"
                ],
                "parameters": [
                    {
                        "name": "report",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/q.opt"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "display"
                                ],
                                "properties": {
                                    "display": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "report",
                                                "display_current",
                                                "display_default",
                                                "display_difference",
                                                "display_default_message_list"
                                            ],
                                            "properties": {
                                                "report": {},
                                                "display_current": {},
                                                "display_default": {},
                                                "display_difference": {},
                                                "display_default_message_list": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/tags": {
            "get": {
                "summary": "Retrieve submission tags",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/tag_response"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Change submission tags",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "tags": {},
                                    "addtags": {},
                                    "deltags": {},
                                    "search": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/tag_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/search_response"
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/alltags": {
            "get": {
                "summary": "Retrieve all visible tags",
                "tags": [
                    "Tags"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "tags"
                                            ],
                                            "properties": {
                                                "tags": {
                                                    "$ref": "#/components/schemas/tag_list"
                                                },
                                                "readonly_tagmap": {},
                                                "sitewide_tagmap": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/assigntags": {
            "post": {
                "summary": "Change several tags",
                "tags": [
                    "Tags"
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "tagassignment"
                                ],
                                "properties": {
                                    "tagassignment": {
                                        "type": "string",
                                        "description": "Comma-separated list of paper IDs and tag assignments"
                                    },
                                    "search": {
                                        "$ref": "#/components/schemas/search_parameter_specification"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/search_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "p"
                                            ],
                                            "properties": {
                                                "p": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/taganno": {
            "get": {
                "summary": "Retrieve tag annotations",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "name": "tag",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "$ref": "#/components/schemas/tag"
                        }
                    },
                    {
                        "name": "search",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "$ref": "#/components/schemas/search_parameter_specification"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/search_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "tag",
                                                "editable",
                                                "anno"
                                            ],
                                            "properties": {
                                                "tag": {
                                                    "$ref": "#/components/schemas/tag"
                                                },
                                                "editable": {
                                                    "type": "boolean"
                                                },
                                                "anno": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/tag_annotation"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Change tag annotations",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "name": "tag",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    },
                    {
                        "name": "search",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "anno"
                                ],
                                "properties": {
                                    "anno": {
                                        "type": "array",
                                        "items": {
                                            "$ref": "#/components/schemas/tag_annotation"
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "$ref": "#/components/schemas/search_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "tag",
                                                "editable",
                                                "anno"
                                            ],
                                            "properties": {
                                                "tag": {
                                                    "$ref": "#/components/schemas/tag"
                                                },
                                                "editable": {
                                                    "type": "boolean"
                                                },
                                                "anno": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/tag_annotation"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/tagmessages": {
            "get": {
                "summary": "Retrieve tag edit messages",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "pid"
                                            ],
                                            "properties": {
                                                "pid": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/votereport": {
            "get": {
                "summary": "Retrieve vote analysis",
                "tags": [
                    "Tags"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "name": "tag",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "$ref": "#/components/schemas/tag"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "tag",
                                                "report"
                                            ],
                                            "properties": {
                                                "tag": {},
                                                "report": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/revpref": {
            "get": {
                "tags": [
                    "Review preferences"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "name": "u",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "value",
                                                "pref"
                                            ],
                                            "properties": {
                                                "value": {},
                                                "pref": {},
                                                "prefexp": {},
                                                "topic_score": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Review preferences"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "name": "u",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "pref"
                                ],
                                "properties": {
                                    "pref": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "value",
                                                "pref"
                                            ],
                                            "properties": {
                                                "value": {},
                                                "pref": {},
                                                "prefexp": {},
                                                "topic_score": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/review": {
            "get": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/reviewhistory": {
            "get": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/acceptreview": {
            "post": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/r"
                    },
                    {
                        "$ref": "#/components/parameters/redirect"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "action",
                                                "review_site_relative"
                                            ],
                                            "properties": {
                                                "action": {},
                                                "review_site_relative": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/claimreview": {
            "post": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/r"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/redirect"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "action",
                                                "review_site_relative"
                                            ],
                                            "properties": {
                                                "action": {},
                                                "review_site_relative": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/declinereview": {
            "post": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/r"
                    },
                    {
                        "$ref": "#/components/parameters/redirect"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "reason": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "action",
                                                "review_site_relative"
                                            ],
                                            "properties": {
                                                "action": {},
                                                "reason": {},
                                                "review_site_relative": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/requestreview": {
            "post": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "name": "round",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "email"
                                ],
                                "properties": {
                                    "email": {},
                                    "given_name": {},
                                    "family_name": {},
                                    "name": {},
                                    "affiliation": {},
                                    "override": {},
                                    "reason": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/reviewrating": {
            "get": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/r"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "ratings": {},
                                                "user_rating": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Reviews"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/r"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "user_rating"
                                ],
                                "properties": {
                                    "user_rating": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "ratings": {},
                                                "user_rating": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/reviewtoken": {
            "get": {
                "tags": [
                    "Reviews"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Reviews"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/comment": {
            "get": {
                "summary": "Retrieve comment",
                "description": "The `c` parameter specifies the comment to return. If the comment exists and\nthe user can view it, it will be returned in the `comment` component of the\nresponse. Otherwise, an error response is returned.\n\nIf `c` is omitted, all viewable comments are returned in a `comments` list.\n",
                "tags": [
                    "Comments"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/c.opt"
                    },
                    {
                        "name": "content",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        },
                        "description": "False omits comment content from response"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "comment": {
                                                    "$ref": "#/components/schemas/comment"
                                                },
                                                "comments": {
                                                    "type": "array",
                                                    "items": {
                                                        "$ref": "#/components/schemas/comment"
                                                    }
                                                }
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Create, modify, or delete comment",
                "description": "The `c` parameter specifies the comment to modify. It can be a numeric comment\nID; `new`, to create a new comment; or `response` (or a compound like\n`R2response`), to create or modify a named response.\n\nSetting `delete=1` deletes the specified comment, and the response does not\ncontain a `comment` component. Otherwise the comment is created or modified,\nand the response `comment` component contains the new comment.\n\nComment attachments may be uploaded as files (requiring a request body in\n`multipart/form-data` encoding), or using the [upload API](#operation/upload).\nTo upload a single new attachment:\n\n* Set the `attachment:1` body parameter to `new`\n* Either:\n\t* Set `attachment:1:file` as a uploaded file containing the relevant data\n\t* Or use the [upload API](#operation/upload) to upload the file,\n\t  and supply the upload token in the `attachment:1:upload` body parameter\n\nTo upload multiple attachments, number them sequentially (`attachment:2`,\n`attachment:3`, and so forth). To delete an existing attachment, supply its\n`docid` as an `attachment:N` parameter, and set `attachment:N:delete` to 1.\n",
                "tags": [
                    "Comments"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "$ref": "#/components/parameters/c"
                    },
                    {
                        "name": "override",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    },
                    {
                        "name": "delete",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": "boolean"
                        }
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "text": {
                                        "type": "string"
                                    },
                                    "attachment": {},
                                    "tags": {
                                        "type": "string"
                                    },
                                    "topic": {
                                        "$ref": "#/components/schemas/comment_topic"
                                    },
                                    "visibility": {
                                        "$ref": "#/components/schemas/comment_visibility"
                                    },
                                    "ready": {
                                        "type": "boolean"
                                    },
                                    "draft": {
                                        "type": "boolean"
                                    },
                                    "blind": {
                                        "type": "boolean"
                                    },
                                    "response": {
                                        "type": "string"
                                    },
                                    "by_author": {
                                        "type": "boolean"
                                    },
                                    "review_token": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "comment": {
                                                    "$ref": "#/components/schemas/comment"
                                                },
                                                "conflict": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mentioncompletion": {
            "get": {
                "tags": [
                    "Comments"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "mentioncompletion"
                                            ],
                                            "properties": {
                                                "mentioncompletion": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/track": {
            "post": {
                "tags": [
                    "Meeting tracker"
                ],
                "parameters": [
                    {
                        "name": "track",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    },
                    {
                        "name": "tracker_start_at",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/p.opt"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "hotlist-info": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/trackerstatus": {
            "get": {
                "tags": [
                    "Meeting tracker"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/trackerconfig": {
            "post": {
                "tags": [
                    "Meeting tracker"
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "stopall": {},
                                    "tr": {},
                                    "has_tr": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "tracker_status_at",
                                                "tracker_eventid"
                                            ],
                                            "properties": {
                                                "tracker": {},
                                                "tracker_recent": {},
                                                "tracker_status": {},
                                                "now": {},
                                                "tracker_status_at": {},
                                                "tracker_eventid": {},
                                                "new_trackerid": {},
                                                "tracker_site": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/user": {
            "get": {
                "tags": [
                    "Users"
                ],
                "parameters": [
                    {
                        "name": "email",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "name": "potential_conflict",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "found"
                                            ],
                                            "properties": {
                                                "found": {},
                                                "email": {},
                                                "given_name": {},
                                                "family_name": {},
                                                "affiliation": {},
                                                "potential_conflict": {},
                                                "orcid": {},
                                                "country": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/pc": {
            "get": {
                "tags": [
                    "Users"
                ],
                "parameters": [
                    {
                        "name": "ui",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "pc"
                                            ],
                                            "properties": {
                                                "pc": {},
                                                "tags": {},
                                                "sort": {},
                                                "p": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/clickthrough": {
            "post": {
                "tags": [
                    "Profile"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.opt"
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "clickthrough_id",
                                    "clickthrough_type",
                                    "clickthrough_time"
                                ],
                                "properties": {
                                    "accept": {},
                                    "clickthrough_id": {},
                                    "clickthrough_type": {},
                                    "clickthrough_time": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/events": {
            "get": {
                "tags": [
                    "Notifications"
                ],
                "parameters": [
                    {
                        "name": "from",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "from",
                                                "to",
                                                "rows",
                                                "more"
                                            ],
                                            "properties": {
                                                "from": {},
                                                "to": {},
                                                "rows": {},
                                                "more": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/{p}/follow": {
            "post": {
                "tags": [
                    "Notifications"
                ],
                "parameters": [
                    {
                        "$ref": "#/components/parameters/p.path"
                    },
                    {
                        "name": "u",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "following"
                                ],
                                "properties": {
                                    "following": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "following"
                                            ],
                                            "properties": {
                                                "following": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/mailtext": {
            "get": {
                "tags": [
                    "Site information"
                ],
                "parameters": [
                    {
                        "name": "template",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "$ref": "#/components/parameters/p.opt"
                    },
                    {
                        "$ref": "#/components/parameters/r.opt"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "given_name",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "family_name",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "affiliation",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "reason",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "width",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "text",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "subject",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "body",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "templates": {},
                                                "subject": {},
                                                "body": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/account": {
            "get": {
                "tags": [
                    "Site administration"
                ],
                "parameters": [
                    {
                        "name": "email",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "email",
                                                "disabled",
                                                "placeholder"
                                            ],
                                            "properties": {
                                                "email": {},
                                                "disabled": {},
                                                "placeholder": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Site administration"
                ],
                "parameters": [
                    {
                        "name": "email",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    },
                    {
                        "name": "disable",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "enable",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "sendinfo",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "email",
                                                "disabled",
                                                "placeholder"
                                            ],
                                            "properties": {
                                                "email": {},
                                                "disabled": {},
                                                "placeholder": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/namedformula": {
            "get": {
                "tags": [
                    "Site administration"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "formulas"
                                            ],
                                            "properties": {
                                                "formulas": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Site administration"
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "formula"
                                ],
                                "properties": {
                                    "formula": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "formulas"
                                            ],
                                            "properties": {
                                                "formulas": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/settings": {
            "get": {
                "tags": [
                    "Settings"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "settings"
                                            ],
                                            "properties": {
                                                "settings": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Settings"
                ],
                "parameters": [
                    {
                        "name": "dry_run",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "reset",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    },
                    {
                        "name": "filename",
                        "in": "query",
                        "required": false,
                        "schema": {}
                    }
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "properties": {
                                    "settings": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "settings"
                                            ],
                                            "properties": {
                                                "dry_run": {},
                                                "change_list": {},
                                                "settings": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/reviewfieldlibrary": {
            "get": {
                "tags": [
                    "Settings"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "samples",
                                                "types"
                                            ],
                                            "properties": {
                                                "samples": {},
                                                "types": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/settingdescriptions": {
            "get": {
                "tags": [
                    "Settings"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "setting_descriptions"
                                            ],
                                            "properties": {
                                                "setting_descriptions": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/submissionfieldlibrary": {
            "get": {
                "tags": [
                    "Settings"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "samples",
                                                "types"
                                            ],
                                            "properties": {
                                                "samples": {},
                                                "types": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/job": {
            "get": {
                "tags": [
                    "Session"
                ],
                "parameters": [
                    {
                        "name": "job",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "update_at"
                                            ],
                                            "properties": {
                                                "update_at": {},
                                                "status": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/jserror": {
            "post": {
                "tags": [
                    "Session"
                ],
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/x-www-form-urlencoded": {
                            "schema": {
                                "type": "object",
                                "required": [
                                    "error"
                                ],
                                "properties": {
                                    "error": {},
                                    "url": {},
                                    "lineno": {},
                                    "colno": {},
                                    "stack": {}
                                }
                            }
                        }
                    }
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/oauthtoken": {
            "post": {
                "tags": [
                    "Session"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/minimal_response"
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/session": {
            "get": {
                "tags": [
                    "Session"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "sessioninfo"
                                            ],
                                            "properties": {
                                                "sessioninfo": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "tags": [
                    "Session"
                ],
                "parameters": [
                    {
                        "name": "v",
                        "in": "query",
                        "required": true,
                        "schema": {}
                    }
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "required": [
                                                "sessioninfo"
                                            ],
                                            "properties": {
                                                "sessioninfo": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/whoami": {
            "get": {
                "tags": [
                    "Session"
                ],
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "allOf": [
                                        {
                                            "$ref": "#/components/schemas/minimal_response"
                                        },
                                        {
                                            "type": "object",
                                            "properties": {
                                                "email": {},
                                                "given_name": {},
                                                "family_name": {},
                                                "affiliation": {}
                                            }
                                        }
                                    ]
                                }
                            }
                        }
                    },
                    "default": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/error_response"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "parameters": {
            "redirect": {
                "name": "redirect",
                "in": "query",
                "required": false,
                "schema": {
                    "type": "string"
                }
            },
            "p.path": {
                "name": "p",
                "in": "path",
                "required": true,
                "schema": {
                    "$ref": "#/components/schemas/pid"
                }
            },
            "p": {
                "name": "p",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/pid"
                }
            },
            "r": {
                "name": "r",
                "in": "query",
                "required": true,
                "schema": {
                    "$ref": "#/components/schemas/rid"
                }
            },
            "p.opt": {
                "name": "p",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/pid"
                }
            },
            "r.opt": {
                "name": "r",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/rid"
                }
            },
            "c.opt": {
                "name": "c",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/cid"
                }
            },
            "c": {
                "name": "c",
                "in": "query",
                "required": true,
                "schema": {
                    "$ref": "#/components/schemas/cid"
                }
            },
            "q": {
                "name": "q",
                "in": "query",
                "required": true,
                "schema": {
                    "$ref": "#/components/schemas/search_string"
                }
            },
            "q.opt": {
                "name": "q",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/search_string"
                }
            },
            "t": {
                "name": "t",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/search_collection"
                }
            },
            "qt": {
                "name": "qt",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/search_qt"
                }
            },
            "reviewer": {
                "name": "reviewer",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/search_reviewer"
                }
            },
            "sort": {
                "name": "sort",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/search_sort"
                }
            },
            "scoresort": {
                "name": "scoresort",
                "in": "query",
                "required": false,
                "schema": {
                    "$ref": "#/components/schemas/search_scoresort"
                }
            },
            "forceShow": {
                "name": "forceShow",
                "in": "query",
                "required": false,
                "schema": {
                    "type": "boolean"
                }
            }
        },
        "schemas": {
            "message": {
                "type": "object",
                "required": [
                    "status"
                ],
                "properties": {
                    "status": {
                        "type": "integer",
                        "minimum": -5,
                        "maximum": 3
                    },
                    "field": {
                        "type": "string"
                    },
                    "message": {
                        "type": "string"
                    },
                    "context": {
                        "$ref": "#/components/schemas/message_context"
                    },
                    "pos1": {
                        "title": "start position",
                        "type": "integer"
                    },
                    "pos2": {
                        "title": "end position",
                        "type": "integer"
                    }
                },
                "examples": [
                    {
                        "status": 0,
                        "message": "<0>Helpful message"
                    },
                    {
                        "status": 2,
                        "field": "abstract",
                        "message": "<0>Entry required to complete submission"
                    }
                ]
            },
            "message_list": {
                "type": "array",
                "description": "Diagnostic list",
                "items": {
                    "$ref": "#/components/schemas/message"
                },
                "examples": [
                    [],
                    [
                        {
                            "status": 2,
                            "message": "<0>Function not found"
                        }
                    ]
                ]
            },
            "message_context": {
                "type": "array",
                "prefixItems": [
                    {
                        "title": "substring",
                        "type": "string"
                    },
                    {
                        "title": "start position",
                        "type": "integer"
                    },
                    {
                        "title": "end position",
                        "type": "integer"
                    }
                ]
            },
            "minimal_response": {
                "type": "object",
                "required": [
                    "ok"
                ],
                "properties": {
                    "ok": {
                        "type": "boolean"
                    },
                    "message_list": {
                        "$ref": "#/components/schemas/message_list"
                    }
                }
            },
            "error_response": {
                "type": "object",
                "required": [
                    "ok"
                ],
                "properties": {
                    "ok": {
                        "type": "boolean",
                        "description": "always false"
                    },
                    "message_list": {
                        "$ref": "#/components/schemas/message_list"
                    },
                    "status_code": {
                        "type": "integer"
                    }
                }
            },
            "pid": {
                "type": "integer",
                "description": "Submission ID",
                "minimum": 1
            },
            "mimetype": {
                "type": "string",
                "description": "MIME type",
                "examples": [
                    "application/pdf",
                    "image/png"
                ]
            },
            "paper_status": {
                "type": "string",
                "description": "Submission status",
                "examples": [
                    "draft",
                    "submitted",
                    "withdrawn"
                ]
            },
            "rid": {
                "oneOf": [
                    {
                        "type": "integer",
                        "minimum": 1
                    },
                    {
                        "type": "string"
                    }
                ],
                "description": "Review ID"
            },
            "cid": {
                "oneOf": [
                    {
                        "type": "integer",
                        "minimum": 1
                    },
                    {
                        "type": "string",
                        "examples": [
                            "new",
                            "response",
                            "R2response"
                        ]
                    }
                ],
                "description": "Comment ID"
            },
            "document_name": {
                "type": "string",
                "examples": [
                    "testconf-paper1.pdf"
                ]
            },
            "document_type": {
                "type": "integer"
            },
            "document_id": {
                "type": "integer",
                "minimum": 1,
                "description": "Document ID"
            },
            "offset_range": {
                "type": "array",
                "prefixItems": [
                    {
                        "type": "integer",
                        "description": "First offset"
                    },
                    {
                        "type": "integer",
                        "description": "Last offset"
                    }
                ]
            },
            "upload_token": {
                "type": "string",
                "description": "Token for file upload",
                "examples": [
                    "hcupwhvGDVmHNYyDKdqeqA"
                ]
            },
            "hotlist": {
                "type": "object",
                "description": "Properties of submission list or user list",
                "properties": {
                    "listid": {
                        "type": "string"
                    },
                    "description": {
                        "type": "string"
                    },
                    "urlbase": {
                        "type": "string"
                    },
                    "highlight": {
                        "type": "boolean"
                    },
                    "ids": {
                        "$ref": "#/components/schemas/encoded_pid_list"
                    }
                },
                "examples": [
                    {
                        "listid": "p/s/1-40",
                        "description": "1-40 in Submitted",
                        "urlbase": "search?t=s",
                        "ids": "Q3ihaiilFkB"
                    }
                ]
            },
            "hotlist_input": {
                "allOf": [
                    {
                        "$ref": "#/components/schemas/hotlist"
                    },
                    {
                        "type": "object",
                        "properties": {
                            "digest": {
                                "type": "string"
                            },
                            "curid": {
                                "type": "integer"
                            },
                            "previd": {
                                "type": "integer"
                            },
                            "nextid": {
                                "type": "integer"
                            }
                        }
                    }
                ],
                "description": "Properties of submission list or user list"
            },
            "encoded_pid_list": {
                "type": "string",
                "description": "Encoded list of nonnegative submission IDs",
                "examples": [
                    "Q3ihaiilFkB",
                    "1 2 3-10 5"
                ]
            },
            "encoded_search_parameters": {
                "type": "string",
                "description": "URL-encoded search parameters",
                "examples": [
                    "q=&t=s&sort=id&forceShow=&report=pl"
                ]
            },
            "search_string": {
                "type": "string",
                "description": "Search query",
                "examples": [
                    "1-10 OR #ready"
                ]
            },
            "search_collection": {
                "type": "string",
                "description": "Collection to search",
                "examples": [
                    "s",
                    "all"
                ]
            },
            "search_qt": {
                "type": "string",
                "description": "Search fields"
            },
            "search_sort": {
                "type": "string",
                "description": "Sort order",
                "examples": [
                    "id",
                    "-title"
                ]
            },
            "search_scoresort": {
                "type": "string",
                "description": "Sort order for scores",
                "examples": [
                    "counts",
                    "average"
                ]
            },
            "search_reviewer": {
                "type": "string",
                "description": "Email of designated reviewer for search",
                "examples": [
                    "pcmember@uhcrp.edu"
                ]
            },
            "search_parameters": {
                "type": "object",
                "description": "Search parameters",
                "required": [
                    "q"
                ],
                "properties": {
                    "q": {
                        "$ref": "#/components/schemas/search_string"
                    },
                    "t": {
                        "$ref": "#/components/schemas/search_collection"
                    },
                    "qt": {
                        "$ref": "#/components/schemas/search_qt"
                    },
                    "sort": {
                        "$ref": "#/components/schemas/search_sort"
                    },
                    "scoresort": {
                        "$ref": "#/components/schemas/search_scoresort"
                    },
                    "reviewer": {
                        "$ref": "#/components/schemas/search_reviewer"
                    }
                }
            },
            "search_parameter_specification": {
                "oneOf": [
                    {
                        "$ref": "#/components/schemas/encoded_search_parameters"
                    },
                    {
                        "$ref": "#/components/schemas/search_parameters"
                    }
                ],
                "examples": [
                    "q=",
                    "{\"q\":\"hello\",\"t\":\"all\"}"
                ]
            },
            "search_response": {
                "type": "object",
                "description": "Search result",
                "required": [
                    "ids",
                    "groups",
                    "hotlist",
                    "search_params"
                ],
                "properties": {
                    "ids": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/pid"
                        }
                    },
                    "groups": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/tag_annotation"
                        }
                    },
                    "hotlist": {
                        "$ref": "#/components/schemas/hotlist"
                    },
                    "search_params": {
                        "$ref": "#/components/schemas/encoded_search_parameters"
                    }
                }
            },
            "tag": {
                "type": "string",
                "description": "Tag",
                "pattern": "^~?~?[a-zA-Z@*_:.][-+a-zA-Z0-9?!@*_:.\\/]*$",
                "examples": [
                    "discuss",
                    "For_Evaluation",
                    "~mine"
                ]
            },
            "tag_list": {
                "type": "array",
                "description": "List of tag names",
                "items": {
                    "$ref": "#/components/schemas/tag"
                },
                "examples": [
                    [
                        "discuss",
                        "~mine"
                    ],
                    []
                ]
            },
            "tag_value": {
                "type": "string",
                "description": "Tag with value",
                "pattern": "^~?~?[a-zA-Z@*_:.][-+a-zA-Z0-9?!@*_:.\\/]*#\\d+\\.?\\d*$",
                "examples": [
                    "discuss#0",
                    "For_Evaluation#2.1",
                    "~mine#1"
                ]
            },
            "tag_value_list": {
                "type": "array",
                "description": "List of tag names with values",
                "items": {
                    "$ref": "#/components/schemas/tag_value"
                },
                "examples": [
                    [
                        "discuss#0",
                        "~mine#1"
                    ],
                    []
                ]
            },
            "tag_response": {
                "type": "object",
                "required": [
                    "pid",
                    "tags",
                    "tags_edit_text",
                    "tags_view_html",
                    "tag_decoration_html",
                    "color_classes"
                ],
                "properties": {
                    "pid": {
                        "$ref": "#/components/schemas/pid"
                    },
                    "tags": {
                        "$ref": "#/components/schemas/tag_value_list"
                    },
                    "tags_edit_text": {
                        "type": "string",
                        "description": "Textual representation for editing"
                    },
                    "tags_view_html": {
                        "type": "string",
                        "description": "HTML representation for display"
                    },
                    "tag_decoration_html": {
                        "type": "string",
                        "description": "HTML representation of badges and emoji"
                    },
                    "color_classes": {
                        "$ref": "#/components/schemas/style_classes"
                    },
                    "tags_conflicted": {
                        "$ref": "#/components/schemas/tag_value_list"
                    },
                    "color_classes_conflicted": {
                        "$ref": "#/components/schemas/style_classes"
                    }
                }
            },
            "style_classes": {
                "type": "string",
                "description": "Space-separated list of tag style classes",
                "examples": [
                    "tag-red tagbg",
                    "",
                    "tag-rgb-000000 tag-bold dark tagbg"
                ]
            },
            "tag_annotation": {
                "type": "object",
                "description": "Annotation for tag or submission group",
                "required": [
                    "annoid"
                ],
                "properties": {
                    "pos": {
                        "type": "integer",
                        "minimum": 0,
                        "description": "Position of annotation in associated submission list"
                    },
                    "annoid": {
                        "type": "integer"
                    },
                    "tag": {
                        "$ref": "#/components/schemas/tag"
                    },
                    "tagval": {
                        "type": "number"
                    },
                    "blank": {
                        "type": "boolean"
                    },
                    "legend": {
                        "type": "string"
                    }
                }
            },
            "comment_topic": {
                "type": "string",
                "enum": [
                    "paper",
                    "rev",
                    "dec"
                ]
            },
            "comment_visibility": {
                "type": "string",
                "enum": [
                    "admin",
                    "pc",
                    "rev",
                    "au"
                ]
            },
            "paper": {
                "type": "object",
                "required": [
                    "object",
                    "pid",
                    "status"
                ],
                "properties": {
                    "object": {
                        "type": "string",
                        "const": "paper"
                    },
                    "pid": {
                        "$ref": "#/components/schemas/pid"
                    },
                    "status": {
                        "$ref": "#/components/schemas/paper_status"
                    }
                }
            },
            "comment": {
                "type": "object",
                "required": [
                    "object",
                    "pid",
                    "cid"
                ],
                "properties": {
                    "object": {
                        "type": "string",
                        "const": "comment"
                    },
                    "pid": {
                        "$ref": "#/components/schemas/pid"
                    },
                    "cid": {
                        "type": "integer",
                        "minimum": 1
                    },
                    "ordinal": {
                        "type": "string"
                    },
                    "editable": {
                        "type": "boolean"
                    },
                    "viewer_owned": {
                        "type": "boolean"
                    },
                    "visibility": {
                        "$ref": "#/components/schemas/comment_visibility"
                    },
                    "topic": {
                        "$ref": "#/components/schemas/comment_topic"
                    },
                    "blind": {
                        "type": "boolean"
                    },
                    "draft": {
                        "type": "boolean"
                    },
                    "collapsed": {
                        "type": "boolean"
                    },
                    "response": {
                        "type": "string"
                    },
                    "author_editable": {
                        "type": "boolean"
                    },
                    "by_author": {
                        "type": "boolean"
                    },
                    "by_shepherd": {
                        "type": "boolean"
                    },
                    "format": {
                        "type": "integer"
                    },
                    "review_token": {
                        "type": "string"
                    },
                    "tags": {
                        "type": "string"
                    },
                    "color_classes": {
                        "$ref": "#/components/schemas/style_classes"
                    },
                    "author": {
                        "type": "string"
                    },
                    "author_email": {
                        "type": "string"
                    },
                    "author_hidden": {
                        "type": "boolean"
                    },
                    "author_pseudonym": {
                        "type": "string"
                    },
                    "author_pseudonymous": {
                        "type": "boolean"
                    },
                    "modified_at": {
                        "type": "integer"
                    },
                    "modified_at_obscured": {
                        "type": "boolean"
                    },
                    "modified_at_text": {
                        "type": "string"
                    },
                    "text": {
                        "type": "string"
                    },
                    "docs": {
                        "type": "array",
                        "items": {}
                    },
                    "word_count": {
                        "type": "integer"
                    }
                },
                "description": "Comment representation"
            }
        },
        "securitySchemes": {
            "apiToken": {
                "type": "http",
                "scheme": "bearer",
                "description": "API token created via Profile > Developer"
            },
            "session": {
                "type": "apiKey",
                "in": "cookie",
                "name": "hotcrpsession",
                "description": "Web sessions use a cookie. The name of the cookie varies by installation; `hotcrpcookie` is used on hotcrp.com. Operations other than GET and HEAD also require a `post` query parameter"
            }
        }
    },
    "tags": [
        {
            "name": "Submissions",
            "description": "These endpoints query and modify HotCRP submissions.\n\n\n"
        },
        {
            "name": "Documents"
        },
        {
            "name": "Submission administration"
        },
        {
            "name": "Search",
            "description": "These endpoints perform searches on submissions.\n\n\n"
        },
        {
            "name": "Tags"
        },
        {
            "name": "Review preferences"
        },
        {
            "name": "Reviews"
        },
        {
            "name": "Comments",
            "description": "These endpoints query and modify submission comments.\n\nEach comment has a *visibility* and a *topic* (which in the UI is called a\n*thread*). These values control who can see the comment.\n\nThe default comment visibility is `\"rev\"`, which makes the comment visible to\nPC and external reviewers. Other values are `\"admin\"` (visible only to\nsubmission administrators and the comment author), `\"pc\"` (visible to PC\nreviewers, but not external reviewers), and `\"au\"` (visible to authors and\nreviewers).\n\nThe default comment topic is `\"rev\"`, the review thread. Comments on the\nreview thread are visible to users who can see reviews; if you can’t see\nreviews, you can’t see the review thread. Other comment topics are `\"paper\"`,\nthe submission thread (visible to anyone who can see the submission), and\n`\"dec\"`, the decision thread (visible to users who can see the submission’s\ndecision).\n\n\n"
        },
        {
            "name": "Meeting tracker"
        },
        {
            "name": "Users"
        },
        {
            "name": "Profile"
        },
        {
            "name": "Notifications"
        },
        {
            "name": "Site information"
        },
        {
            "name": "Site administration"
        },
        {
            "name": "Settings"
        },
        {
            "name": "Session"
        }
    ],
    "security": [
        {
            "apiToken": [],
            "session": []
        }
    ]
}