rename rust crate fatcat-api-spec -> fatcat-openapi

1 files changed, 0 insertions, 3129 deletions

diff --git a/rust/fatcat-api-spec/api.yaml b/rust/fatcat-api-spec/api.yaml
deleted file mode 100644
index 95ef4c6b..00000000
--- a/rust/fatcat-api-spec/api.yaml
+++ /dev/null
@@ -1,3129 +0,0 @@
----
-swagger: "2.0"
-info:
-  title: fatcat
-  description: A scalable, versioned, API-oriented catalog of bibliographic entities
-    and file metadata
-  version: 0.3.0
-schemes: [https]
-basePath: /v0
-host: api.fatcat.wiki
-consumes:
-  - application/json
-produces:
-  - application/json
-
-securityDefinitions:
-  Bearer:
-    type: apiKey
-    name: Authorization
-    in: header
-
-tags: # TAGLINE
- - name: containers # TAGLINE
-   descriptions: "Container entities: such as journals, conferences, book series" # TAGLINE
- - name: creators # TAGLINE
-   descriptions: "Creator entities: such as authors" # TAGLINE
- - name: files # TAGLINE
-   descriptions: "File entities" # TAGLINE
- - name: filesets # TAGLINE
-   descriptions: "Fileset entities" # TAGLINE
- - name: webcaptures # TAGLINE
-   descriptions: "Webcapture entities" # TAGLINE
- - name: releases # TAGLINE
-   descriptions: "Release entities: individual articles, pre-prints, books" # TAGLINE
- - name: works # TAGLINE
-   descriptions: "Work entities: grouping releases which are variants of the same work" # TAGLINE
- - name: edit-lifecycle # TAGLINE
-   descriptions: "Endpoints relating to global edit submission and history" # TAGLINE
-
-# don't want these to be rust types (at least for now)
-x-fatcat-ident: &FATCATIDENT
-  type: string
-  example: "q3nouwy3nnbsvo3h5klxsx4a7y"
-  pattern: "[a-zA-Z2-7]{26}"
-  minLength: 26
-  maxLength: 26
-  description: "base32-encoded unique identifier"
-x-fatcat-uuid: &FATCATUUID
-  type: string
-  example: "86daea5b-1b6b-432a-bb67-ea97795f80fe"
-  pattern: "[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}"
-  minLength: 36
-  maxLength: 36
-  description: "UUID (lower-case, dash-separated, hex-encoded 128-bit)"
-x-issn: &FATCATISSN
-  type: string
-  example: "1234-5678"
-  pattern: "\\d{4}-\\d{3}[0-9X]"
-  minLength: 9
-  maxLength: 9
-x-orcid: &FATCATORCID
-  type: string
-  example: "0000-0002-1825-0097"
-  pattern: "\\d{4}-\\d{4}-\\d{4}-\\d{3}[\\dX]"
-  minLength: 19
-  maxLength: 19
-x-md5: &FATCATMD5
-  type: string
-  example: "1b39813549077b2347c0f370c3864b40"
-  pattern: "[a-f0-9]{32}"
-  minLength: 32
-  maxLength: 32
-x-sha1: &FATCATSHA1
-  type: string
-  example: "e9dd75237c94b209dc3ccd52722de6931a310ba3"
-  pattern: "[a-f0-9]{40}"
-  minLength: 40
-  maxLength: 40
-x-sha256: &FATCATSHA256
-  type: string
-  example: "cb1c378f464d5935ddaa8de28446d82638396c61f042295d7fb85e3cccc9e452"
-  pattern: "[a-f0-9]{64}"
-  minLength: 64
-  maxLength: 64
-
-# Common properties across entities
-x-entity-props: &ENTITYPROPS
-  state:
-    type: string
-    enum: ["wip", "active", "redirect", "deleted"]
-  ident:
-    <<: *FATCATIDENT
-  revision:
-    <<: *FATCATUUID
-  redirect:
-    <<: *FATCATIDENT
-  extra:
-    type: object
-    additionalProperties: {}
-  edit_extra:
-    type: object
-    additionalProperties: {}
-
-definitions:
-  error_response:
-    type: object
-    required:
-      - success
-      - error
-      - message
-    properties:
-      success:
-        type: boolean
-      error:
-        type: string
-      message:
-        type: string
-        example: "A really confusing, totally unexpected thing happened"
-  success:
-    type: object
-    required:
-      - success
-      - message
-    properties:
-      success:
-        type: boolean
-      message:
-        type: string
-        example: "The computers did the thing successfully!"
-  container_entity:
-    type: object
-    # required for creation: name
-    properties:
-      <<: *ENTITYPROPS
-      name:
-        type: string
-        example: "Journal of Important Results"
-        description: "Required for valid entities"
-      container_type:
-        type: string
-        description: "Eg, 'journal'"
-      publisher:
-        type: string
-        example: "Society of Curious Students"
-      issnl:
-        <<: *FATCATISSN
-      wikidata_qid:
-        type: string
-  creator_entity:
-    type: object
-    # required for creation: display_name
-    properties:
-      <<: *ENTITYPROPS
-      display_name:
-        type: string
-        example: "Grace Hopper"
-        description: "Required for valid entities"
-      given_name:
-        type: string
-      surname:
-        type: string
-      orcid:
-        <<: *FATCATORCID
-      wikidata_qid:
-        type: string
-  file_entity:
-    type: object
-    properties:
-      <<: *ENTITYPROPS
-      size:
-        type: integer
-        example: 1048576
-        format: int64
-      md5:
-        <<: *FATCATMD5
-      sha1:
-        <<: *FATCATSHA1
-      sha256:
-        <<: *FATCATSHA256
-      urls:
-        type: array
-        items:
-          $ref: "#/definitions/file_url"
-      mimetype:
-        type: string
-        example: "application/pdf"
-      release_ids:
-        type: array
-        items:
-          <<: *FATCATIDENT
-      releases:
-        description: "Optional; GET-only"
-        type: array
-        items:
-          $ref: "#/definitions/release_entity"
-  file_url:
-    type: object
-    required:
-      - url
-      - rel
-    properties:
-      url:
-        type: string
-        format: url
-        example: "https://example.edu/~frau/prcding.pdf"
-      rel:
-        type: string
-        example: "webarchive"
-  fileset_entity:
-    type: object
-    properties:
-      <<: *ENTITYPROPS
-      manifest:
-        # limit of 200 files, at least to start
-        type: array
-        items:
-          $ref: "#/definitions/fileset_file"
-      urls:
-        type: array
-        items:
-          $ref: "#/definitions/fileset_url"
-      release_ids:
-        type: array
-        items:
-          <<: *FATCATIDENT
-      releases:
-        description: "Optional; GET-only"
-        type: array
-        items:
-          $ref: "#/definitions/release_entity"
-  fileset_url:
-    type: object
-    required:
-      - url
-      - rel
-    properties:
-      url:
-        type: string
-        format: url
-        example: "https://example.edu/~frau/prcding.pdf"
-      rel:
-        type: string
-        example: "webarchive"
-  fileset_file:
-    type: object
-    required:
-      - path
-      - size
-    properties:
-      path:
-        type: string
-        example: "img/cat.png"
-      size:
-        type: integer
-        example: 1048576
-        format: int64
-      md5:
-        <<: *FATCATMD5
-      sha1:
-        <<: *FATCATSHA1
-      sha256:
-        <<: *FATCATSHA256
-      extra:
-        type: object
-        additionalProperties: {}
-  webcapture_entity:
-    type: object
-    properties:
-      <<: *ENTITYPROPS
-      cdx:
-        # limit of 200 CDX lines, at least to start?
-        type: array
-        items:
-          $ref: "#/definitions/webcapture_cdx_line"
-      archive_urls:
-        type: array
-        items:
-          $ref: "#/definitions/webcapture_url"
-      original_url:
-        type: string
-        format: url
-        example: "http://asheesh.org"
-      timestamp:
-        type: string
-        format: date-time
-        description: "same format as CDX line timestamp (UTC, etc). Corresponds to the overall capture timestamp. Can be the earliest or average of CDX timestamps if that makes sense."
-      release_ids:
-        type: array
-        items:
-          <<: *FATCATIDENT
-      releases:
-        description: "Optional; GET-only"
-        type: array
-        items:
-          $ref: "#/definitions/release_entity"
-  webcapture_cdx_line:
-    type: object
-    required:
-      - surt
-      - timestamp
-      - url
-      - sha1
-    properties:
-      surt:
-        type: string
-        example: "org,asheesh)/apus/ch1/node15.html"
-      timestamp:
-        type: string
-        format: date-time
-        example: "2016-09-19T17:20:24Z"
-        description: "UTC, 'Z'-terminated, second (or better) precision"
-      url:
-        type: string
-        # NOTE: not format:url to allow alternatives
-        example: "http://www.asheesh.org:80/APUS/ch1/node15.html"
-      mimetype:
-        type: string
-        example: "text/html"
-      status_code:
-        type: integer
-        example: 200
-        format: int64
-      size:
-        type: integer
-        example: 1048576
-        format: int64
-      sha1:
-        <<: *FATCATSHA1
-      sha256:
-        <<: *FATCATSHA256
-  webcapture_url:
-    type: object
-    required:
-      - url
-      - rel
-    properties:
-      url:
-        type: string
-        format: url
-        example: "https://web.archive.org/web/"
-      rel:
-        type: string
-        example: "wayback"
-  release_entity:
-    type: object
-    # required for creation: title
-    required:
-      - ext_ids
-    properties:
-      <<: *ENTITYPROPS
-      title:
-        type: string
-        description: "Required for valid entities. The title used in citations and for display; usually English"
-      subtitle:
-        type: string
-        description: "Avoid this field if possible, and merge with title; usually English"
-      original_title:
-        type: string
-        description: "Title in original language (or, the language of the full text of this release)"
-      work_id:
-        type: string
-        example: "q3nouwy3nnbsvo3h5klxsx4a7y"
-      container:
-        $ref: "#/definitions/container_entity"
-        description: "Optional; GET-only"
-      files:
-        description: "Optional; GET-only"
-        type: array
-        items:
-          $ref: "#/definitions/file_entity"
-      filesets:
-        description: "Optional; GET-only"
-        type: array
-        items:
-          $ref: "#/definitions/fileset_entity"
-      webcaptures:
-        description: "Optional; GET-only"
-        type: array
-        items:
-          $ref: "#/definitions/webcapture_entity"
-      container_id:
-        type: string
-        example: "q3nouwy3nnbsvo3h5klxsx4a7y"
-      release_type:
-        type: string
-        example: "book"
-      release_stage:
-        type: string
-        example: "preprint, retracted"
-      release_date:
-        type: string
-        format: date
-      release_year:
-        type: integer
-        example: 2014
-        format: int64
-      withdrawn_status:
-        type: string
-      withdrawn_date:
-        type: string
-        format: date
-      withdrawn_year:
-        type: integer
-        example: 2014
-        format: int64
-      ext_ids:
-        $ref: "#/definitions/release_ext_ids"
-      volume:
-        type: string
-      issue:
-        type: string
-        example: "12"
-      pages:
-        type: string
-      number:
-        type: string
-      version:
-        type: string
-      publisher:
-        type: string
-      language:
-        description: "Two-letter RFC1766/ISO639-1 language code, with extensions"
-        type: string
-      license_slug:
-        type: string
-        description: "Short version of license name. Eg, 'CC-BY'"
-      contribs:
-        type: array
-        items:
-          $ref: "#/definitions/release_contrib"
-      refs:
-        type: array
-        items:
-          $ref: "#/definitions/release_ref"
-      abstracts:
-        type: array
-        items:
-          $ref: "#/definitions/release_abstract"
-  release_ext_ids:
-    type: object
-    properties:
-      doi:
-        type: string
-        #format: custom
-        example: "10.1234/abcde.789"
-      wikidata_qid:
-        type: string
-      isbn13:
-        type: string
-        #format: custom
-      pmid:
-        type: string
-      pmcid:
-        type: string
-      core:
-        type: string
-        #format: custom
-      arxiv:
-        type: string
-      jstor:
-        type: string
-      ark:
-        type: string
-      mag:
-        type: string
-  release_abstract:
-    type: object
-    properties:
-      sha1:
-        <<: *FATCATSHA1
-      content:
-        type: string
-        example: "<jats:p>Some abstract thing goes here</jats:p>"
-      mimetype:
-        type: string
-        example: "application/xml+jats"
-      lang:
-        type: string
-        example: "en"
-  work_entity:
-    type: object
-    properties:
-      <<: *ENTITYPROPS
-  entity_history_entry:
-    type: object
-    required:
-      - edit
-      - editgroup
-      - changelog_entry
-    properties:
-      edit:
-        $ref: "#/definitions/entity_edit"
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      changelog_entry:
-        $ref: "#/definitions/changelog_entry"
-  entity_edit:
-    type: object
-    required:
-      - edit_id
-      - ident
-      - editgroup_id
-    properties:
-      edit_id:
-          <<: *FATCATUUID
-      ident:
-          <<: *FATCATIDENT
-      revision:
-          <<: *FATCATUUID
-      prev_revision:
-          <<: *FATCATUUID
-      redirect_ident:
-          <<: *FATCATIDENT
-      editgroup_id:
-          <<: *FATCATIDENT
-      extra:
-          type: object
-          additionalProperties: {}
-  editor:
-    type: object
-    required:
-      - username
-    properties:
-      editor_id:
-        <<: *FATCATIDENT
-      username:
-        type: string
-        example: "zerocool93"
-      is_admin:
-        type: boolean
-      is_bot:
-        type: boolean
-      is_active:
-        type: boolean
-  editgroup:
-    type: object
-    properties:
-      editgroup_id:
-        <<: *FATCATIDENT
-      editor_id:
-        <<: *FATCATIDENT
-      editor:
-        $ref: "#/definitions/editor"
-      changelog_index: # not returned in all contexts...
-        type: integer
-        example: 1048576
-        format: int64
-      created:
-        type: string
-        format: date-time
-      submitted:
-        type: string
-        format: date-time
-      description:
-        type: string
-      extra:
-        type: object
-        additionalProperties: {}
-      annotations:
-        type: array
-        items:
-          $ref: "#/definitions/editgroup_annotation"
-      edits:
-        type: object
-        properties:
-          containers:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-          creators:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-          files:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-          filesets:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-          webcaptures:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-          releases:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-          works:
-            type: array
-            items:
-              $ref: "#/definitions/entity_edit"
-  editgroup_annotation:
-    type: object
-    properties:
-      annotation_id:
-        <<: *FATCATUUID
-      editgroup_id:
-        <<: *FATCATIDENT
-      editor_id:
-        <<: *FATCATIDENT
-      editor:
-        $ref: "#/definitions/editor"
-      created:
-        type: string
-        format: date-time
-      comment_markdown:
-        type: string
-      extra:
-        type: object
-        additionalProperties: {}
-  changelog_entry:
-    type: object
-    required:
-      - index
-      - editgroup_id
-      - timestamp
-    properties:
-      index:
-        type: integer
-        format: int64
-      editgroup_id:
-        type: string
-        example: "q3nouwy3nnbsvo3h5klxsx4a7y"
-      timestamp:
-        type: string
-        format: date-time
-      editgroup:
-        $ref: "#/definitions/editgroup"
-  release_ref:
-    type: object
-    properties:
-      index:
-        type: integer
-        format: int64
-      target_release_id:
-        <<: *FATCATIDENT
-      extra:
-        type: object
-        additionalProperties: {}
-      key:
-        type: string
-      year:
-        type: integer
-        format: int64
-      container_name:
-        type: string
-      title:
-        type: string
-      locator:
-        type: string
-        example: "p123"
-  release_contrib:
-    type: object
-    properties:
-      index:
-        type: integer
-        format: int64
-      creator_id:
-        <<: *FATCATIDENT
-      creator:
-        $ref: "#/definitions/creator_entity"
-        description: "Optional; GET-only"
-      raw_name:
-        type: string
-      given_name:
-        type: string
-      surname:
-        type: string
-      role:
-        type: string
-      raw_affiliation:
-        type: string
-        description: "Raw affiliation string as displayed in text"
-      extra:
-        type: object
-        additionalProperties: {}
-  container_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-          $ref: "#/definitions/container_entity"
-  creator_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-          $ref: "#/definitions/creator_entity"
-  file_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-          $ref: "#/definitions/file_entity"
-  fileset_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-          $ref: "#/definitions/fileset_entity"
-  webcapture_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-          $ref: "#/definitions/webcapture_entity"
-  release_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-          $ref: "#/definitions/release_entity"
-  work_auto_batch:
-    type: object
-    required:
-      - editgroup
-      - entity_list
-    properties:
-      editgroup:
-        $ref: "#/definitions/editgroup"
-      entity_list:
-        type: array
-        items:
-            $ref: "#/definitions/work_entity"
-  auth_oidc:
-    type: object
-    required:
-      - provider
-      - sub
-      - iss
-      - preferred_username
-    properties:
-      provider:
-        type: string
-      sub:
-        type: string
-      iss:
-        type: string
-      preferred_username:
-        type: string
-  auth_oidc_result:
-    type: object
-    required:
-      - editor
-      - token
-    properties:
-      editor:
-        $ref: "#/definitions/editor"
-      token:
-        type: string
-
-x-auth-responses: &AUTHRESPONSES
-  401:
-    description: Not Authorized # "Authentication information is missing or invalid"
-    schema:
-      $ref: "#/definitions/error_response"
-    headers:
-      WWW_Authenticate:
-        type: string
-  403:
-    description: Forbidden
-    schema:
-      $ref: "#/definitions/error_response"
-x-entity-responses: &ENTITYRESPONSES
-  400:
-    description: Bad Request
-    schema:
-      $ref: "#/definitions/error_response"
-  404:
-    description: Not Found
-    schema:
-      $ref: "#/definitions/error_response"
-  500:
-    description: Generic Error
-    schema:
-      $ref: "#/definitions/error_response"
-
-paths:
-  /editgroup/{editgroup_id}/container:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_container"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/container_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/container/batch:
-    post:
-      operationId: "create_container_auto_batch"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/container_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /container/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_container"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For containers, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For containers, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/container_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/container/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_container"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/container_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_container"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /container/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_container_revision"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For containers, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For containers, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/container_entity"
-        <<: *ENTITYRESPONSES
-  /container/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      tags: # TAGLINE
-        - containers # TAGLINE
-      operationId: "get_container_history"
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /container/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - containers # TAGLINE
-      operationId: "get_container_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /container/lookup:
-    get:
-      operationId: "lookup_container"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: issnl
-          in: query
-          required: false
-          <<: *FATCATISSN
-        - name: wikidata_qid
-          in: query
-          required: false
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For container, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/container_entity"
-        <<: *ENTITYRESPONSES
-  /container/edit/{edit_id}:
-    get:
-      operationId: "get_container_edit"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/container/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_container_edit"
-      tags: # TAGLINE
-        - containers # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/creator:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_creator"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/creator_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/creator/batch:
-    post:
-      operationId: "create_creator_auto_batch"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/creator_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /creator/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_creator"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For creators, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For containers, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/creator_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/creator/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_creator"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/creator_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_creator"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /creator/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_creator_revision"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For creators, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For creators, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/creator_entity"
-        <<: *ENTITYRESPONSES
-  /creator/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_creator_history"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /creator/{ident}/releases:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: hide
-        in: query
-        type: string
-        required: false
-        description: "List of entity fields to elide in response. For creators, none implemented yet."
-    get:
-      operationId: "get_creator_releases"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/release_entity"
-        <<: *ENTITYRESPONSES
-  /creator/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - creators # TAGLINE
-      operationId: "get_creator_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /creator/lookup:
-    get:
-      operationId: "lookup_creator"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: orcid
-          in: query
-          required: false
-          <<: *FATCATORCID
-        - name: wikidata_qid
-          in: query
-          required: false
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For creator, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/creator_entity"
-        <<: *ENTITYRESPONSES
-  /creator/edit/{edit_id}:
-    get:
-      operationId: "get_creator_edit"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/creator/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_creator_edit"
-      tags: # TAGLINE
-        - creators # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/file:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_file"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/file_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/file/batch:
-    post:
-      operationId: "create_file_auto_batch"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/file_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /file/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_file"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For files, `releases` is accepted."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For files, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/file_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/file/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_file"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/file_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_file"
-      tags: # TAGLINE
-        - files # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /file/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_file_revision"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For files, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For files, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/file_entity"
-        <<: *ENTITYRESPONSES
-  /file/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_file_history"
-      tags: # TAGLINE
-        - files # TAGLINE
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /file/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - files # TAGLINE
-      operationId: "get_file_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /file/lookup:
-    get:
-      operationId: "lookup_file"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: md5
-          in: query
-          required: false
-          <<: *FATCATMD5
-        - name: sha1
-          in: query
-          required: false
-          <<: *FATCATSHA1
-        - name: sha256
-          in: query
-          required: false
-          <<: *FATCATSHA256
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For files, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/file_entity"
-        <<: *ENTITYRESPONSES
-  /file/edit/{edit_id}:
-    get:
-      operationId: "get_file_edit"
-      tags: # TAGLINE
-        - files # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/file/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_file_edit"
-      tags: # TAGLINE
-        - files # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/fileset:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_fileset"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/fileset_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/fileset/batch:
-    post:
-      operationId: "create_fileset_auto_batch"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/fileset_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /fileset/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_fileset"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For filesets, `releases` is accepted."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For filesets, 'manifest' is accepted."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/fileset_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/fileset/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_fileset"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/fileset_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_fileset"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /fileset/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_fileset_revision"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For filesets, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For filesets, 'manifest' is accepted."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/fileset_entity"
-        <<: *ENTITYRESPONSES
-  /fileset/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_fileset_history"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /fileset/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      operationId: "get_fileset_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /fileset/edit/{edit_id}:
-    get:
-      operationId: "get_fileset_edit"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/fileset/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_fileset_edit"
-      tags: # TAGLINE
-        - filesets # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/webcapture:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_webcapture"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/webcapture_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/webcapture/batch:
-    post:
-      operationId: "create_webcapture_auto_batch"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/webcapture_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /webcapture/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_webcapture"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For webcaptures, `releases` is accepted."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For webcaptures, 'cdx' is accepted."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/webcapture_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/webcapture/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_webcapture"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/webcapture_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_webcapture"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /webcapture/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_webcapture_revision"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For webcaptures, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For webcaptures, 'cdx' is accepted."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/webcapture_entity"
-        <<: *ENTITYRESPONSES
-  /webcapture/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_webcapture_history"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /webcapture/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      operationId: "get_webcapture_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /webcapture/edit/{edit_id}:
-    get:
-      operationId: "get_webcapture_edit"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/webcapture/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_webcapture_edit"
-      tags: # TAGLINE
-        - webcaptures # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/release:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_release"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/release_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/release/batch:
-    post:
-      operationId: "create_release_auto_batch"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/release_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /release/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_release"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For releases, 'files', 'filesets, 'webcaptures', 'container', and 'creators' are valid."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For releases, 'abstracts', 'refs', and 'contribs' are valid."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/release_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/release/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_release"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/release_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_release"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /release/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_release_revision"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For releases, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For releases, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/release_entity"
-        <<: *ENTITYRESPONSES
-  /release/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_release_history"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /release/{ident}/files:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: hide
-        in: query
-        type: string
-        required: false
-        description: "List of entity fields to elide in response. For files, none accepted (yet)."
-    get:
-      operationId: "get_release_files"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/file_entity"
-        <<: *ENTITYRESPONSES
-  /release/{ident}/filesets:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: hide
-        in: query
-        type: string
-        required: false
-        description: "List of entity fields to elide in response. For filesets, 'manifest' is valid."
-    get:
-      operationId: "get_release_filesets"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/fileset_entity"
-        <<: *ENTITYRESPONSES
-  /release/{ident}/webcaptures:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: hide
-        in: query
-        type: string
-        required: false
-        description: "List of entity fields to elide in response. For webcaptures, 'cdx' is valid."
-    get:
-      operationId: "get_release_webcaptures"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/webcapture_entity"
-        <<: *ENTITYRESPONSES
-  /release/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - releases # TAGLINE
-      operationId: "get_release_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /release/lookup:
-    get:
-      operationId: "lookup_release"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: doi
-          in: query
-          type: string
-          required: false
-        - name: wikidata_qid
-          in: query
-          type: string
-          required: false
-        - name: isbn13
-          in: query
-          type: string
-          required: false
-        - name: pmid
-          in: query
-          type: string
-          required: false
-        - name: pmcid
-          in: query
-          type: string
-          required: false
-        - name: core
-          in: query
-          type: string
-          required: false
-        - name: arxiv
-          in: query
-          type: string
-          required: false
-        - name: jstor
-          in: query
-          type: string
-          required: false
-        - name: ark
-          in: query
-          type: string
-          required: false
-        - name: mag
-          in: query
-          type: string
-          required: false
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For releases, 'files', 'filesets, 'webcaptures', 'container', and 'creators' are valid."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/release_entity"
-        <<: *ENTITYRESPONSES
-  /release/edit/{edit_id}:
-    get:
-      operationId: "get_release_edit"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/release/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_release_edit"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/work:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-    post:
-      operationId: "create_work"
-      tags: # TAGLINE
-        - releases # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/work_entity"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editgroup/auto/work/batch:
-    post:
-      operationId: "create_work_auto_batch"
-      tags: # TAGLINE
-        - works # TAGLINE
-      parameters:
-        - name: auto_batch
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/work_auto_batch"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Created Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /work/{ident}:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_work"
-      tags: # TAGLINE
-        - works # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For works, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For works, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity
-          schema:
-            $ref: "#/definitions/work_entity"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/work/{ident}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        type: string
-        required: true
-      - name: ident
-        in: path
-        type: string
-        required: true
-    put:
-      operationId: "update_work"
-      tags: # TAGLINE
-        - works # TAGLINE
-      parameters:
-        - name: entity
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/work_entity"
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Updated Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-    delete:
-      operationId: "delete_work"
-      tags: # TAGLINE
-        - works # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Entity
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /work/rev/{rev_id}:
-    parameters:
-      - name: rev_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    get:
-      operationId: "get_work_revision"
-      tags: # TAGLINE
-        - works # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For works, none accepted (yet)."
-        - name: hide
-          in: query
-          type: string
-          required: false
-          description: "List of entity fields to elide in response. For works, none accepted (yet)."
-      responses:
-        200:
-          description: Found Entity Revision
-          schema:
-            $ref: "#/definitions/work_entity"
-        <<: *ENTITYRESPONSES
-  /work/{ident}/history:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_work_history"
-      tags: # TAGLINE
-        - works # TAGLINE
-      responses:
-        200:
-          description: Found Entity History
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/entity_history_entry"
-        <<: *ENTITYRESPONSES
-  /work/{ident}/redirects:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-    get:
-      tags: # TAGLINE
-        - works # TAGLINE
-      operationId: "get_work_redirects"
-      responses:
-        200:
-          description: Found Entity Redirects
-          schema:
-            type: array
-            items:
-              <<: *FATCATIDENT
-        <<: *ENTITYRESPONSES
-  /work/{ident}/releases:
-    parameters:
-      - name: ident
-        in: path
-        type: string
-        required: true
-      - name: hide
-        in: query
-        type: string
-        required: false
-        description: "List of entity fields to elide in response. For works, none implemented yet."
-    get:
-      operationId: "get_work_releases"
-      tags: # TAGLINE
-        - works # TAGLINE
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/release_entity"
-        <<: *ENTITYRESPONSES
-  /work/edit/{edit_id}:
-    get:
-      operationId: "get_work_edit"
-      tags: # TAGLINE
-        - works # TAGLINE
-      parameters:
-        - name: edit_id
-          in: path
-          required: true
-          <<: *FATCATUUID
-      responses:
-        200:
-          description: Found Edit
-          schema:
-            $ref: "#/definitions/entity_edit"
-        <<: *ENTITYRESPONSES
-  /editgroup/{editgroup_id}/work/edit/{edit_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        type: string
-      - name: edit_id
-        in: path
-        required: true
-        <<: *FATCATUUID
-    delete:
-      operationId: "delete_work_edit"
-      tags: # TAGLINE
-        - works # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Deleted Edit
-          schema:
-            $ref: "#/definitions/success"
-        <<: *ENTITYRESPONSES
-        <<: *AUTHRESPONSES
-  /editor/{editor_id}:
-    parameters:
-      - name: editor_id
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_editor"
-      responses:
-        200:
-          description: Found
-          schema:
-            $ref: "#/definitions/editor"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-    put:
-      operationId: "update_editor"
-      parameters:
-       - name: editor
-         in: body
-         required: true
-         schema:
-           $ref: "#/definitions/editor"
-      security:
-       - Bearer: []
-      responses:
-        200:
-          description: Updated Editor
-          schema:
-            $ref: "#/definitions/editor"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editor/{editor_id}/editgroups:
-    parameters:
-      - name: editor_id
-        in: path
-        type: string
-        required: true
-    get:
-      operationId: "get_editor_editgroups"
-      parameters:
-        - name: limit
-          in: query
-          type: integer
-          format: int64
-          required: false
-        - name: before
-          in: query
-          type: string
-          format: date-time
-          required: false
-        - name: since
-          in: query
-          type: string
-          format: date-time
-          required: false
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/editgroup"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-  /editor/{editor_id}/annotations:
-    parameters:
-      - name: editor_id
-        in: path
-        required: true
-        <<: *FATCATIDENT
-    get:
-      operationId: "get_editor_annotations"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      parameters:
-        - name: limit
-          in: query
-          type: integer
-          format: int64
-          required: false
-        - name: before
-          in: query
-          type: string
-          format: date-time
-          required: false
-        - name: since
-          in: query
-          type: string
-          format: date-time
-          required: false
-      responses:
-        200:
-          description: Success
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/editgroup_annotation"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editgroup:
-    post:
-      operationId: "create_editgroup"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      parameters:
-        - name: editgroup
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/editgroup"
-      security:
-        - Bearer: []
-      responses:
-        201:
-          description: Successfully Created
-          schema:
-            $ref: "#/definitions/editgroup"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404: # added only for response type consistency
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        <<: *FATCATIDENT
-    get:
-      operationId: "get_editgroup"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      responses:
-        200:
-          description: Found
-          schema:
-            $ref: "#/definitions/editgroup"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-    put:
-      operationId: "update_editgroup"
-      security:
-        - Bearer: []
-      parameters:
-        - name: editgroup
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/editgroup"
-        - name: submit
-          in: query
-          type: boolean
-          required: false
-      responses:
-        200:
-          description: Updated Editgroup
-          schema:
-            $ref: "#/definitions/editgroup"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/accept:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        <<: *FATCATIDENT
-    post:
-      operationId: "accept_editgroup"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      security:
-        - Bearer: []
-      responses:
-        200:
-          description: Merged Successfully
-          schema:
-            $ref: "#/definitions/success"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        409:
-          description: Edit Conflict
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/annotations:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        <<: *FATCATIDENT
-    get:
-      operationId: "get_editgroup_annotations"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For editgroups: 'editors'"
-      responses:
-        200:
-          description: Success
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/editgroup_annotation"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editgroup/{editgroup_id}/annotation:
-    parameters:
-      - name: editgroup_id
-        in: path
-        required: true
-        <<: *FATCATIDENT
-    post:
-      operationId: "create_editgroup_annotation"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      security:
-        - Bearer: []
-      parameters:
-        - name: annotation
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/editgroup_annotation"
-      responses:
-        201:
-          description: Created
-          schema:
-            $ref: "#/definitions/editgroup_annotation"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /editgroup/reviewable:
-    get:
-      operationId: "get_editgroups_reviewable"
-      parameters:
-        - name: expand
-          in: query
-          type: string
-          required: false
-          description: "List of sub-entities to expand in response. For editgroups: 'editors'"
-        - name: limit
-          in: query
-          type: integer
-          format: int64
-          required: false
-        - name: before
-          in: query
-          type: string
-          format: date-time
-          required: false
-        - name: since
-          in: query
-          type: string
-          format: date-time
-          required: false
-      responses:
-        200:
-          description: Found
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/editgroup"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-  /changelog:
-    parameters:
-      - name: limit
-        in: query
-        type: integer
-        format: int64
-        required: false
-    get:
-      operationId: "get_changelog"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      responses:
-        200:
-          description: Success
-          schema:
-            type: array
-            items:
-              $ref: "#/definitions/changelog_entry"
-        400: # added only for response type consistency
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-  /changelog/{index}:
-    parameters:
-      - name: index
-        in: path
-        type: integer
-        format: int64
-        required: true
-    get:
-      operationId: "get_changelog_entry"
-      tags: # TAGLINE
-        - edit-lifecycle # TAGLINE
-      responses:
-        200:
-          description: Found Changelog Entry
-          schema:
-            $ref: "#/definitions/changelog_entry"
-        400: # added only for response type consistency
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        404:
-          description: Not Found
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-  /auth/oidc:
-    post:
-      operationId: "auth_oidc"
-      tags: # TAGLINE
-      security:
-        # required admin privs
-        - Bearer: []
-      parameters:
-        - name: oidc_params
-          in: body
-          required: true
-          schema:
-            $ref: "#/definitions/auth_oidc"
-      responses:
-        200:
-          description: Found
-          schema:
-            $ref: "#/definitions/auth_oidc_result"
-        201:
-          description: Created
-          schema:
-            $ref: "#/definitions/auth_oidc_result"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        409:
-          description: Conflict
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-  /auth/check:
-    get:
-      operationId: "auth_check"
-      tags: # TAGLINE
-      security:
-        # required admin privs
-        - Bearer: []
-      parameters:
-        - name: role
-          in: query
-          required: false
-          type: string
-      responses:
-        200:
-          description: Success
-          schema:
-            $ref: "#/definitions/success"
-        400:
-          description: Bad Request
-          schema:
-            $ref: "#/definitions/error_response"
-        500:
-          description: Generic Error
-          schema:
-            $ref: "#/definitions/error_response"
-        <<: *AUTHRESPONSES
-