openapi: 3.0.0
info:
  description: Specification for Cocina Models
  version: 1.0.0
  title: Cocina Models
  license:
    name: Apache 2.0
    url: 'http://www.apache.org/licenses/LICENSE-2.0.html'
paths:
  /validate/DRO:
    post:
      summary: Validate a DRO
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DRO'
      responses:
        '200':
          description: noop
  /validate/RequestDRO:
    post:
      summary: Validate a Request DRO
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestDRO'
      responses:
        '200':
          description: noop
  /validate/DROWithMetadata:
    post:
      summary: Validate a DRO with object metadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DROWithMetadata'
      responses:
        '200':
          description: noop
  /validate/Collection:
    post:
      summary: Validate a Collection
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Collection'
      responses:
        '200':
          description: noop
  /validate/RequestCollection:
    post:
      summary: Validate a Request Collection
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestCollection'
      responses:
        '200':
          description: noop
  /validate/CollectionWithMetadata:
    post:
      summary: Validate a Collection with object metadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CollectionWithMetadata'
      responses:
        '200':
          description: noop
  /validate/AdminPolicy:
    post:
      summary: Validate an AdminPolicy
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminPolicy'
      responses:
        '200':
          description: noop
  /validate/RequestAdminPolicy:
    post:
      summary: Validate a Request AdminPolicy
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestAdminPolicy'
      responses:
        '200':
          description: noop
  /validate/AdminPolicyWithMetadata:
    post:
      summary: Validate an AdminPolicy with object metadata
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdminPolicyWithMetadata'
      responses:
        '200':
          description: noop
  /validate/Description:
    post:
      summary: Validate a Description
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Description'
      responses:
        '200':
          description: noop
  /validate/RequestDescription:
    post:
      summary: Validate a Request Description
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestDescription'
      responses:
        '200':
          description: noop
components:
  schemas:
    Access:
      type: object
      oneOf:
        # Being first, makes DarkAccess the default.
        - $ref: '#/components/schemas/DarkAccess'
        - $ref: '#/components/schemas/CitationOnlyAccess'
        - $ref: '#/components/schemas/ControlledDigitalLendingAccess'
        - $ref: '#/components/schemas/LocationBasedAccess'
        - $ref: '#/components/schemas/LocationBasedDownloadAccess'
        - $ref: '#/components/schemas/StanfordAccess'
        - $ref: '#/components/schemas/WorldAccess'
    AccessRole:
      description: Access role conferred by an AdminPolicy to objects within it. (used by Argo)
      type: object
      additionalProperties: false
      properties:
        name:
          description: Name of role
          type: string
          enum:
            - 'dor-apo-depositor'
            - 'dor-apo-manager'
            - 'dor-apo-viewer'
            - 'sdr-administrator'
            - 'sdr-viewer'
            - 'hydrus-collection-creator'
            - 'hydrus-collection-manager'
            - 'hydrus-collection-depositor'
            - 'hydrus-collection-item-depositor'
            - 'hydrus-collection-reviewer'
            - 'hydrus-collection-viewer'
        members:
          description: The users and groups that are members of the role
          type: array
          items:
            $ref: '#/components/schemas/AccessRoleMember'
      required:
        - members
        - name
    AccessRoleMember:
      description: Represents a user or group that is a member of an AccessRole
      type: object
      additionalProperties: false
      properties:
        type:
          description: Name of role
          type: string
          enum:
            - 'sunetid'
            - 'workgroup'
        identifier:
          type: string
      required:
        - identifier
        - type
    Administrative:
      type: object
      additionalProperties: false
      properties:
        hasAdminPolicy:
          $ref: '#/components/schemas/Druid'
        releaseTags:
          description: Tags for release
          type: array
          items:
            $ref: '#/components/schemas/ReleaseTag'
      required:
        - hasAdminPolicy
    AdminPolicy:
      type: object
      additionalProperties: false
      properties:
        cocinaVersion:
          $ref: '#/components/schemas/CocinaVersion'
        type:
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/admin_policy'
        externalIdentifier:
          $ref: '#/components/schemas/Druid'
        label:
          type: string
        version:
          type: integer
        administrative:
          $ref: '#/components/schemas/AdminPolicyAdministrative'
        description:
          $ref: '#/components/schemas/Description'
      required:
        - cocinaVersion
        - administrative
        - externalIdentifier
        - label
        - type
        - version
    AdminPolicyAdministrative:
      description: Administrative properties for an AdminPolicy
      type: object
      additionalProperties: false
      properties:
        accessTemplate:
          $ref: '#/components/schemas/AdminPolicyAccessTemplate'
        registrationWorkflow:
          description: When you register an item with this admin policy, these are the workflows that are available.
          type: array
          items:
            type: string
        disseminationWorkflow:
          description: An additional workflow to start for objects managed by this admin policy once the end-accession workflow step is complete
          example: wasCrawlPreassemblyWF
          type: string
        collectionsForRegistration:
          description: When you register an item with this admin policy, these are the collections that are available.
          type: array
          items:
            type: string
        hasAdminPolicy:
          $ref: '#/components/schemas/Druid'
        hasAgreement:
          $ref: '#/components/schemas/Druid'
        roles:
          description: The access roles conferred by this AdminPolicy (used by Argo)
          type: array
          items:
            $ref: '#/components/schemas/AccessRole'
      required:
        - hasAdminPolicy
        - hasAgreement
        - accessTemplate
    AdminPolicyAccessTemplate:
      description: 'Provides the template of access settings that is copied to the items goverend by an AdminPolicy. This is almost the same as DROAccess, but it provides no defaults and has no embargo.'
      type: object
      additionalProperties: false
      properties:
        view:
          type: string
          enum:
            - 'world'
            - 'stanford'
            - 'location-based'
            - 'citation-only'
            - 'dark'
        controlledDigitalLending:
          description: Available for controlled digital lending.
          type: boolean
        copyright:
          description: The human readable copyright statement that applies
          example: Copyright World Trade Organization
          type: string
          nullable: true
        download:
          description: >
            Download access level. This is used in the transition from Fedora as
            a way to set a default download level at registration that is copied
            down to all the files.

          type: string
          enum:
            - 'world'
            - 'stanford'
            - 'location-based'
            - 'none'
        location:
          description: >
            If access or download is "location-based", this indicates which
            location should have access. This is used in the transition from
            Fedora as a way to set a default location at registration that is
            copied down to all the files.

          type: string
          nullable: true
          enum:
            - 'spec'
            - 'music'
            - 'ars'
            - 'art'
            - 'hoover'
            - 'm&m'
        useAndReproductionStatement:
          description: The human readable use and reproduction statement that applies
          example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
          type: string
          nullable: true
        license:
          description: The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
          type: string
          nullable: true
    # AdminPolicyWithMetadata schema should not be copied to sdr-api and dor-services-app.
    AdminPolicyWithMetadata:
      description: Admin Policy with addition object metadata.
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/AdminPolicy"
        - $ref: "#/components/schemas/ObjectMetadata"
    AppliesTo:
      description: Property model for indicating the parts, aspects, or versions of the resource to which a
        descriptive element is applicable.
      type: object
      additionalProperties: false
      properties:
        appliesTo:
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveBasicValue"
    Barcode:
      description: 'A barcode'
      oneOf:
        - $ref: '#/components/schemas/BusinessBarcode'
        - $ref: '#/components/schemas/LaneMedicalBarcode'
        - $ref: '#/components/schemas/CatkeyBarcode'
        - $ref: '#/components/schemas/StandardBarcode'
    BusinessBarcode:
      description: The barcode associated with a business library DRO object, prefixed with 2050
      type: string
      pattern: '^2050[0-9]{7}$'
      example: '20503740296'
    LaneMedicalBarcode:
      description: The barcode associated with a Lane Medical Library DRO object, prefixed with 245
      type: string
      pattern: '^245[0-9]{8}$'
      example: '24503259768'
    CatalogLink:
      type: object
      additionalProperties: false
      properties:
        catalog:
          description: Catalog that is the source of the linked record.
          type: string
          enum:
            - symphony
            - previous symphony
          example: symphony
        refresh:
          description: Only one of the catkeys should be designated for refreshing.
            This means that this key is the one used to pull metadata from the catalog
            if there is more than one key present.
          type: boolean
          default: false
        catalogRecordId:
          description: Record identifier that is unique within the context of the linked record's catalog.
          type: string
          pattern: '^\d+(:\d+)*$'
          example: '11403803'
      required:
        - catalog
        - catalogRecordId
        - refresh
    CatkeyBarcode:
      description: The barcode associated with a DRO object based on catkey, prefixed with a catkey followed by a hyphen
      type: string
      pattern: '^[0-9]+-[0-9]+$'
      example: '6772719-1001'
    CitationOnlyAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          enum:
            - citation-only
        download:
          description: Download access level.
          type: string
          enum:
            - 'none'
        location:
          description: Not used for this access type, must be null.
          type: string
          nullable: true
          enum:
            - null
        controlledDigitalLending:
          type: boolean
          default: false
          enum:
            - false
      required:
        - view
        - download
    CocinaVersion:
      description: The version of Cocina with which this object conforms.
      type: string
      pattern: '^\d+\.\d+\.\d+$'
      example: '1.2.3'
    Collection:
      description: A group of Digital Repository Objects that indicate some type of conceptual grouping within the domain that is worth reusing across the system.
      type: object
      additionalProperties: false
      properties:
        cocinaVersion:
            $ref: '#/components/schemas/CocinaVersion'
        type:
          description: The content type of the Collection. Selected from an established set of values.
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/collection'
            - 'https://cocina.sul.stanford.edu/models/curated-collection'
            - 'https://cocina.sul.stanford.edu/models/user-collection'
            - 'https://cocina.sul.stanford.edu/models/exhibit'
            - 'https://cocina.sul.stanford.edu/models/series'
        externalIdentifier:
          $ref: '#/components/schemas/Druid'
        label:
          description: Primary processing label (can be same as title) for a Collection.
          type: string
        version:
          description: Version for the Collection within SDR.
          type: integer
        access:
          $ref: '#/components/schemas/CollectionAccess'
        administrative:
          $ref: '#/components/schemas/Administrative'
        description:
          $ref: '#/components/schemas/Description'
        identification:
          $ref: '#/components/schemas/CollectionIdentification'
      required:
        - cocinaVersion
        - description
        - externalIdentifier
        - label
        - type
        - version
        - access
        - administrative
        - identification
    CollectionAccess:
      description: Access metadata for collections
      type: object
      additionalProperties: false
      properties:
        view:
          description: Access level
          type: string
          enum:
            - 'world'
            - 'dark'
          default: 'dark'
        copyright:
          description: The human readable copyright statement that applies
          example: Copyright World Trade Organization
          type: string
          nullable: true
        useAndReproductionStatement:
          description: The human readable use and reproduction statement that applies
          example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
          type: string
          nullable: true
        license:
          description: The license governing reuse of the Collection. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
          type: string
          nullable: true
    CollectionIdentification:
      type: object
      additionalProperties: false
      properties:
        catalogLinks:
          type: array
          items:
            $ref: '#/components/schemas/CatalogLink'
        sourceId:
          $ref: '#/components/schemas/SourceId'
    # CollectionWithMetadata schema should not be copied to sdr-api and dor-services-app.
    CollectionWithMetadata:
      description: Collection with addition object metadata.
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/Collection"
        - $ref: "#/components/schemas/ObjectMetadata"
    Contributor:
      description: Property model for describing agents contributing in some way to
        the creation and history of the resource.
      type: object
      additionalProperties: false
      properties:
        name:
          description: Names associated with a contributor.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        type:
          description: Entity type of the contributor (person, organization, etc.). See https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md for valid types.
          type: string
        status:
          description: Status of the contributor relative to other parallel contributors
            (e.g. the primary author among a group of contributors).
          type: string
        role:
          description: Relationships of the contributor to the resource or to an event
            in its history.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        identifier:
          description: Identifiers and URIs associated with the contributor entity.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        note:
          description: Other information associated with the contributor.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        valueAt:
          description: URL or other pointer to the location of the contributor information.
          type: string
        parallelContributor:
          description: For multiple representations of information about the same contributor (e.g. in different languages).
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveParallelContributor"
    ControlledDigitalLendingAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          enum:
            - stanford
        download:
          description: Download access level.
          type: string
          enum:
            - none
        location:
          description: Not used for this access type, must be null.
          type: string
          nullable: true
          enum:
            - null
        controlledDigitalLending:
          description: Available for controlled digital lending.
          type: boolean
          default: false
      required:
        - view
        - download
    DarkAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          default: 'dark'
          enum:
            - dark
        download:
          description: Download access level.
          type: string
          default: 'none'
          enum:
            - 'none'
        location:
          description: Not used for this access type, must be null.
          type: string
          nullable: true
          default: null
          enum:
            - null
        controlledDigitalLending:
          type: boolean
          default: false
          enum:
            - false
    Description:
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/RequestDescription"
        - type: object
          additionalProperties: false
          properties:
            purl:
              $ref: "#/components/schemas/Purl"
          required:
            - purl
    DescriptiveAccessMetadata:
      description: Information about how to access digital and physical versions of the object.
      type: object
      additionalProperties: false
      properties:
        url:
          description: URLs where the resource may be accessed in full or part.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        physicalLocation:
          description: Location of a physical version of the resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        digitalLocation:
          description: Location of a digital version of the resource, such as a file path for a born digital resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        accessContact:
          description: The library, organization, or person responsible for access to the resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        digitalRepository:
          description: The digital repositories that hold the resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        note:
          description: Other information related to accessing the resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
    DescriptiveAdminMetadata:
      description: Information about this resource description.
      type: object
      additionalProperties: false
      properties:
        contributor:
          description: Contributors to this resource description.
          type: array
          items:
            $ref: "#/components/schemas/Contributor"
        event:
          description: Events in the history of this resource description.
          type: array
          items:
            $ref: "#/components/schemas/Event"
        language:
          description: Languages, scripts, symbolic systems, and notations used
            in this resource description.
          type: array
          items:
            $ref: "#/components/schemas/Language"
        note:
          description: Other information related to this resource description.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        metadataStandard:
          description: Descriptive or content standard(s) to which this resource description conforms.
          type: array
          items:
            $ref: "#/components/schemas/Standard"
        identifier:
          description: Identifiers associated with this resource description.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
    DescriptiveBasicValue:
      description: Basic value model for descriptive elements. Can only have one of value, parallelValue, groupedValue, or structuredValue.
      type: object
      # additionalProperties breaks the validator for allOf, unclear as to why.
      # additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/DescriptiveStructuredValue"
        - $ref: "#/components/schemas/DescriptiveParallelValue"
        - $ref: "#/components/schemas/DescriptiveGroupedValue"
        - type: object
          # additionalProperties breaks the validator for DescriptiveValue, unclear as to why.
          # additionalProperties: false
          properties:
            value:
              description: String or integer value of the descriptive element.
              oneOf:
              - type: string
              # Title note (nonsorting character count) was supposed to be able to accept an integer value,
              # but this triggered a bug in committee:
              # https://github.com/interagent/committee/issues/286
              # - type: integer
            type:
              description: Type of value provided by the descriptive element. See https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md for valid types.
              type: string
            status:
              description: Status of the descriptive element value relative to other instances
                of the element.
              type: string
            code:
              description: Code value of the descriptive element.
              type: string
            uri:
              description: URI value of the descriptive element.
              type: string
              format: uri
            standard:
              # description: Descriptive or content standard to which the value conforms.
              $ref: "#/components/schemas/Standard"
            encoding:
              # description: Encoding schema, standard, or syntax to which the value conforms.
              $ref: "#/components/schemas/Standard"
            identifier:
              description: Identifiers and URIs associated with the descriptive element.
              type: array
              items:
                  $ref: "#/components/schemas/DescriptiveValue"
            source:
              $ref: "#/components/schemas/Source"
            displayLabel:
              description: The preferred display label to use for the descriptive element in access systems.
              type: string
            qualifier:
              description: A term providing information about the circumstances of the statement (e.g., approximate dates).
              type: string
            note:
              description: Other information related to the descriptive element.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            valueLanguage:
              $ref: "#/components/schemas/DescriptiveValueLanguage"
            valueAt:
              description: URL or other pointer to the location of the value of the descriptive element.
              type: string
    DescriptiveGeographicMetadata:
      description: Value model for mods geographic extension metadata
      type: object
      additionalProperties: false
      properties:
        form:
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        subject:
          description: Terms associated with the intellectual content of the related resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
    DescriptiveGroupedValue:
      description: Value model for a set of descriptive elements grouped together in an unstructured way.
      type: object
      additionalProperties: false
      properties:
        groupedValue:
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
    DescriptiveParallelContributor:
      description: Value model for multiple representations of information about the same contributor (e.g. in different languages).
      deprecated: true
      type: object
      additionalProperties: false
      properties:
        name:
          description: Names associated with a contributor.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        type:
          description: Entity type of the contributor (person, organization, etc.). See https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md for valid types.
          type: string
        status:
          description: Status of the contributor relative to other parallel contributors (e.g. the primary author among a group of contributors).
          type: string
        role:
          description: Relationships of the contributor to the resource or to an event in its history.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        identifier:
          description: Identifiers and URIs associated with the contributor entity.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        note:
          description: Other information associated with the contributor.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        valueAt:
          description: URL or other pointer to the location of the contributor information.
          type: string
        valueLanguage:
          # description: Language of the descriptive element value
          $ref: "#/components/schemas/DescriptiveValueLanguage"
    DescriptiveParallelEvent:
      description: Value model for multiple representations of information about the same event (e.g. in different languages).
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/DescriptiveStructuredValue"
        - type: object
          additionalProperties: false
          properties:
            type:
              description: Description of the event (creation, publication, etc.).
              type: string
            displayLabel:
              description: The preferred display label to use for the event in access systems.
              type: string
            date:
              description: Dates associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            contributor:
              description: Contributors associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/Contributor"
            location:
              description: Locations associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            identifier:
              description: Identifiers and URIs associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            note:
              description: Other information about the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            valueLanguage:
              # description: Language of the descriptive element value
              $ref: "#/components/schemas/DescriptiveValueLanguage"
    DescriptiveParallelValue:
      description: Value model for multiple representations of the same information (e.g. in different languages).
      type: object
      additionalProperties: false
      properties:
        parallelValue:
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
    DescriptiveStructuredValue:
      description: Value model for descriptive elements structured as typed, ordered values.
      type: object
      additionalProperties: false
      properties:
        structuredValue:
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
    DescriptiveValue:
      description: Default value model for descriptive elements.
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/DescriptiveBasicValue"
        - $ref: "#/components/schemas/AppliesTo"
    DescriptiveValueLanguage:
      description: Language of the descriptive element value
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/Standard"
        - type: object
          properties:
            valueScript:
              $ref: '#/components/schemas/Standard'
              # description: An alphabet or other notation used to represent a
              #   language or other symbolic system of the descriptive element value.
    DOI:
      description: Digital Object Identifier (https://www.doi.org)
      oneOf:
        - $ref: '#/components/schemas/DoiPattern'
        - $ref: '#/components/schemas/DoiExceptions'
    DoiExceptions:
      type: string
      description: pre-existing Digital Object Identifiers (https://www.doi.org) not matching the pattern (case insensitive)
      pattern: '^10\.(25740\/([vV][aA]90-[cC][tT]15|[sS][yY][xX][aA]-[mM]256|12[qQ][fF]-5243|65[jJ]8-6114)|25936\/629[tT]-[bB][xX]79)$'
      example: '10.25740/12qF-5243'
    DoiPattern:
      type: string
      description: Digital Object Identifier (https://www.doi.org) regex pattern
      # The prod and test prefixes are permitted
      pattern: '^10\.(25740|80343)\/[b-df-hjkmnp-tv-z]{2}[0-9]{3}[b-df-hjkmnp-tv-z]{2}[0-9]{4}$'
      example: '10.25740/bc123df4567'
    DRO:
      description: Domain-defined abstraction of a 'work'. Digital Repository Objects' abstraction is describable for our domain’s purposes, i.e. for management needs within our system.
      type: object
      additionalProperties: false
      properties:
        cocinaVersion:
          $ref: '#/components/schemas/CocinaVersion'
        type:
          description: The content type of the DRO. Selected from an established set of values.
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/object'
            - 'https://cocina.sul.stanford.edu/models/3d'
            - 'https://cocina.sul.stanford.edu/models/agreement'
            - 'https://cocina.sul.stanford.edu/models/book'
            - 'https://cocina.sul.stanford.edu/models/document'
            - 'https://cocina.sul.stanford.edu/models/geo'
            - 'https://cocina.sul.stanford.edu/models/image'
            - 'https://cocina.sul.stanford.edu/models/page'
            - 'https://cocina.sul.stanford.edu/models/photograph'
            - 'https://cocina.sul.stanford.edu/models/manuscript'
            - 'https://cocina.sul.stanford.edu/models/map'
            - 'https://cocina.sul.stanford.edu/models/media'
            - 'https://cocina.sul.stanford.edu/models/track'
            - 'https://cocina.sul.stanford.edu/models/webarchive-binary'
            - 'https://cocina.sul.stanford.edu/models/webarchive-seed'
        externalIdentifier:
          $ref: '#/components/schemas/Druid'
        label:
          description: Primary processing label (can be same as title) for a DRO.
          type: string
        version:
          description: Version for the DRO within SDR.
          type: integer
        access:
          $ref: '#/components/schemas/DROAccess'
        administrative:
          $ref: '#/components/schemas/Administrative'
        description:
          $ref: '#/components/schemas/Description'
        identification:
          $ref: '#/components/schemas/Identification'
        structural:
          $ref: '#/components/schemas/DROStructural'
        geographic:
          $ref: '#/components/schemas/Geographic'
      required:
        - cocinaVersion
        - access
        - administrative
        - description
        - externalIdentifier
        - label
        - type
        - version
        - identification
        - structural
    DROAccess:
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/Access"
        - type: object
          properties:
            copyright:
              description: The human readable copyright statement that applies
              example: Copyright World Trade Organization
              type: string
              nullable: true
            embargo:
              $ref: '#/components/schemas/Embargo'
            useAndReproductionStatement:
              description: The human readable use and reproduction statement that applies
              example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
              type: string
              nullable: true
            license:
              description: The license governing reuse of the DRO. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
              type: string
              nullable: true
              enum:
                - 'https://www.gnu.org/licenses/agpl.txt'
                - 'https://www.apache.org/licenses/LICENSE-2.0'
                - 'https://opensource.org/licenses/BSD-2-Clause'
                - 'https://opensource.org/licenses/BSD-3-Clause'
                - 'https://creativecommons.org/licenses/by/4.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nc/4.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nd/4.0/legalcode'
                - 'https://creativecommons.org/licenses/by-sa/4.0/legalcode'
                - 'https://creativecommons.org/publicdomain/zero/1.0/legalcode'
                - 'https://opensource.org/licenses/cddl1'
                - 'https://www.eclipse.org/legal/epl-2.0'
                - 'https://www.gnu.org/licenses/gpl-3.0-standalone.html'
                - 'https://www.isc.org/downloads/software-support-policy/isc-license/'
                - 'https://www.gnu.org/licenses/lgpl-3.0-standalone.html'
                - 'https://opensource.org/licenses/MIT'
                - 'https://www.mozilla.org/MPL/2.0/'
                - 'https://opendatacommons.org/licenses/by/1-0/'
                - 'http://opendatacommons.org/licenses/odbl/1.0/' # Non cannonical, but in some of our data
                - 'https://opendatacommons.org/licenses/odbl/1-0/'
                - 'https://creativecommons.org/publicdomain/mark/1.0/'
                - 'https://opendatacommons.org/licenses/pddl/1-0/'
                - 'https://creativecommons.org/licenses/by/3.0/legalcode'
                - 'https://creativecommons.org/licenses/by-sa/3.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nd/3.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nc/3.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nc-sa/3.0/legalcode'
                - 'https://creativecommons.org/licenses/by-nc-nd/3.0/legalcode'
                - 'https://cocina.sul.stanford.edu/licenses/none' # Only used in some legacy ETDs and not actually permitted per the Project Chimera docs.
    DROStructural:
      description: Structural metadata
      type: object
      additionalProperties: false
      properties:
        contains:
          description: Filesets that contain the digital representations (Files)
          type: array
          items:
            $ref: '#/components/schemas/FileSet'
        hasMemberOrders:
          description: Provided sequences or orderings of members, including some metadata about each sequence (i.e. sequence label, sequence type, if the sequence is primary, etc.).
          type: array
          items:
            $ref: '#/components/schemas/Sequence'
        isMemberOf:
          description: Collections that this DRO is a member of
          type: array
          items:
            $ref: '#/components/schemas/Druid'
    # DROWithMetadata schema should not be copied to sdr-api and dor-services-app.
    DROWithMetadata:
      description: DRO with addition object metadata.
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/DRO"
        - $ref: "#/components/schemas/ObjectMetadata"
    Druid:
      type: string
      pattern: '^druid:[b-df-hjkmnp-tv-z]{2}[0-9]{3}[b-df-hjkmnp-tv-z]{2}[0-9]{4}$'
      example: 'druid:bc123df4567'
    Embargo:
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/Access"
        - type: object
          properties:
            releaseDate:
              description: Date when the Collection is released from an embargo.
              type: string
              format: date-time
              example: '2029-06-22T07:00:00.000+00:00'
            useAndReproductionStatement:
              description: The human readable use and reproduction statement that applies when the embargo expires.
              example: These materials are in the public domain.
              type: string
              nullable: true
          required:
            - releaseDate
    Event:
      description: Property model for describing events in the history of the resource.
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/DescriptiveStructuredValue"
        - type: object
          additionalProperties: false
          properties:
            type:
              description: Description of the event (creation, publication, etc.).
              type: string
            displayLabel:
              description: The preferred display label to use for the event in access systems.
              type: string
            date:
              description: Dates associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            contributor:
              description: Contributors associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/Contributor"
            location:
              description: Locations associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            identifier:
              description: Identifiers and URIs associated with the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            note:
              description: Other information about the event.
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveValue"
            valueLanguage:
              # description: Language of the descriptive element value
              $ref: "#/components/schemas/DescriptiveValueLanguage"
            parallelEvent:
              description: For multiple representations of information about the same event (e.g. in different languages)
              type: array
              items:
                $ref: "#/components/schemas/DescriptiveParallelEvent"
    File:
      description: Binaries that are the basis of what our domain manages. Binaries here do not include metadata files generated for the domain's own management purposes.
      type: object
      additionalProperties: false
      properties:
        type:
          description: The content type of the File.
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/file'
        externalIdentifier:
          description: Identifier for the resource within the SDR architecture but outside of the repository. UUID. Constant across resource versions. What clients will use calling the repository.
          type: string
        label:
          description: Primary processing label (can be same as title) for a File.
          type: string
        filename:
          description: Filename for a file. Can be same as label.
          type: string
        size:
          description: Size of the File (binary) in bytes.
          type: integer
        version:
          description: Version for the File within SDR.
          type: integer
        hasMimeType:
          description: MIME Type of the File.
          type: string
        use:
          description: Use for the File.
          type: string
        hasMessageDigests:
          type: array
          items:
            $ref: '#/components/schemas/MessageDigest'
        access:
          $ref: '#/components/schemas/FileAccess'
        administrative:
          $ref: '#/components/schemas/FileAdministrative'
        presentation:
          $ref: '#/components/schemas/Presentation'
      required:
        - externalIdentifier
        - label
        - filename
        - type
        - version
        - access
        - administrative
        - hasMessageDigests
    FileAccess:
      description: Access metadata for files
      type: object
      additionalProperties: false
      oneOf:
        # Being first, makes DarkAccess the default.
        - $ref: '#/components/schemas/DarkAccess'
        - $ref: '#/components/schemas/ControlledDigitalLendingAccess'
        - $ref: '#/components/schemas/LocationBasedAccess'
        - $ref: '#/components/schemas/LocationBasedDownloadAccess'
        - $ref: '#/components/schemas/StanfordAccess'
        - $ref: '#/components/schemas/WorldAccess'
    FileAdministrative:
      type: object
      additionalProperties: false
      properties:
        publish:
          type: boolean
          default: false
        sdrPreserve:
          type: boolean
          default: true
        shelve:
          type: boolean
          default: false
      required:
        - publish
        - sdrPreserve
        - shelve
    FileSet:
      description: Relevant groupings of Files. Also called a File Grouping.
      type: object
      additionalProperties: false
      properties:
        type:
          description: The content type of the Fileset.
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/resources/audio'
            - 'https://cocina.sul.stanford.edu/models/resources/attachment'
            - 'https://cocina.sul.stanford.edu/models/resources/document'
            - 'https://cocina.sul.stanford.edu/models/resources/file'
            - 'https://cocina.sul.stanford.edu/models/resources/image'
            - 'https://cocina.sul.stanford.edu/models/resources/main-augmented'
            - 'https://cocina.sul.stanford.edu/models/resources/main-original'
            - 'https://cocina.sul.stanford.edu/models/resources/media'
            - 'https://cocina.sul.stanford.edu/models/resources/object'
            - 'https://cocina.sul.stanford.edu/models/resources/page'
            - 'https://cocina.sul.stanford.edu/models/resources/permissions'
            - 'https://cocina.sul.stanford.edu/models/resources/preview'
            - 'https://cocina.sul.stanford.edu/models/resources/supplement'
            - 'https://cocina.sul.stanford.edu/models/resources/3d'
            - 'https://cocina.sul.stanford.edu/models/resources/thumb'
            - 'https://cocina.sul.stanford.edu/models/resources/video'
        externalIdentifier:
          type: string
        label:
          description: Primary processing label for a Fileset.
          type: string
        version:
          description: Version for the Fileset within SDR.
          type: integer
        structural:
          $ref: '#/components/schemas/FileSetStructural'
      required:
        - externalIdentifier
        - label
        - type
        - version
        - structural
    FileSetStructural:
      description: Structural metadata
      type: object
      additionalProperties: false
      properties:
        contains:
          type: array
          items:
            $ref: '#/components/schemas/File'
    Geographic:
      description: Geographic metadata
      type: object
      additionalProperties: false
      properties:
        iso19139:
          description: Geographic ISO 19139 XML metadata
          type: string
      required:
        - iso19139
    Identification:
      type: object
      additionalProperties: false
      properties:
        barcode:
          $ref: '#/components/schemas/Barcode'
        catalogLinks:
          type: array
          items:
            $ref: '#/components/schemas/CatalogLink'
        doi:
          $ref: '#/components/schemas/DOI'
        sourceId:
          $ref: '#/components/schemas/SourceId'
      required:
        - sourceId
    Language:
      description: Languages, scripts, symbolic systems, and notations used in all
        or part of a resource or its descriptive metadata.
      type: object
      additionalProperties: false
      properties:
        appliesTo:
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveBasicValue"
        code:
          description: Code value of the descriptive element.
          type: string
        displayLabel:
          description: The preferred display label to use for the descriptive element in access systems.
          type: string
        encoding:
          # description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          $ref: "#/components/schemas/Standard"
        groupedValue:
          description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        note:
          description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        parallelValue:
          description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        qualifier:
          type: string
          description: present for mapping to additional schemas in the future and for consistency but not otherwise used
        script:
          $ref: '#/components/schemas/DescriptiveValue'
          # description: An alphabet or other notation used to represent a
          #   language or other symbolic system associated with the resource.
        source:
          $ref: "#/components/schemas/Source"
        status:
          description: Status of the language relative to other parallel language elements (e.g. the primary language)
          type: string
          enum:
            - primary
        standard:
          # description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          $ref: "#/components/schemas/Standard"
        structuredValue:
          description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        uri:
          description: URI value of the descriptive element.
          type: string
          format: uri
        value:
          description: Value of the descriptive element.
          type: string
        valueAt:
          description: URL or other pointer to the location of the language information.
          type: string
        valueLanguage:
          # description: present for mapping to additional schemas in the future and for consistency but not otherwise used
          $ref: "#/components/schemas/DescriptiveValueLanguage"
    LocationBasedAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          enum:
            - location-based
        download:
          description: Download access level.
          type: string
          enum:
            - location-based
            - none
        location:
          description: If access or download is "location-based", which location should have access.
          type: string
          enum:
            - 'spec'
            - 'music'
            - 'ars'
            - 'art'
            - 'hoover'
            - 'm&m'
        controlledDigitalLending:
          type: boolean
          default: false
          enum:
            - false
      required:
        - view
        - download
        - location
    LocationBasedDownloadAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          enum:
            - stanford
            - world
        download:
          description: Download access level.
          type: string
          enum:
            - location-based
        location:
          description: Which location should have download access.
          type: string
          enum:
            - 'spec'
            - 'music'
            - 'ars'
            - 'art'
            - 'hoover'
            - 'm&m'
        controlledDigitalLending:
          type: boolean
          default: false
          enum:
            - false
      required:
        - view
        - download
        - location
    MessageDigest:
      description: The output of the message digest algorithm.
      type: object
      additionalProperties: false
      properties:
        type:
          description: The algorithm that was used
          type: string
          enum:
            - md5
            - sha1
        digest:
          description: The digest value hexidecimal encoded
          type: string
      required:
        - type
        - digest
    # ObjectMetadata schema should not be copied to sdr-api and dor-services-app.
    ObjectMetadata:
      description: Metadata for a cocina object.
      type: object
      additionalProperties: false
      properties:
        created:
          description: When the object was created.
          type: string
          format: date-time
        modified:
          description: When the object was modified.
          type: string
          format: date-time
        lock:
          description: Key for optimistic locking. The contents of the key is not specified.
          type: string
      required:
        - lock
    Presentation:
      description: Presentation data for the File.
      type: object
      additionalProperties: false
      properties:
        height:
          description: Height in pixels
          type: integer
        width:
          description: Width in pixels
          type: integer
    Purl:
      description: Stanford persistent URL associated with the related resource. Note this is http, not https.
      type: string
      format: uri
      # Canonical URI is https
      pattern: '^https:\/\/'
    RelatedResource:
      description: Other resource associated with the described resource.
      type: object
      additionalProperties: false
      properties:
        type:
          description: The relationship of the related resource to the described resource.
          type: string
        status:
          description: Status of the related resource relative to other related resources.
          type: string
        displayLabel:
          description: The preferred display label to use for the related resource in access systems.
          type: string
        title:
          description: Titles of the related resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        contributor:
          description: Agents contributing in some way to the creation and history of the
            related resource.
          type: array
          items:
            $ref: "#/components/schemas/Contributor"
        event:
          description: Events in the history of the related resource.
          type: array
          items:
            $ref: "#/components/schemas/Event"
        form:
          description: Characteristics of the related resource's physical, digital, and intellectual
            form and genre, and of its process of creation.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        language:
          description: Languages, scripts, symbolic systems, and notations used in all or
            part of a related resource.
          type: array
          items:
            $ref: "#/components/schemas/Language"
        note:
          description: Additional information relevant to a related resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        identifier:
          description: Identifiers and URIs associated with the related resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        standard:
          # description: Descriptive or content standards to which the value conforms.
          $ref: "#/components/schemas/Standard"
        subject:
          description: Terms associated with the intellectual content of the related resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        purl:
          $ref: "#/components/schemas/Purl"
        access:
          $ref: "#/components/schemas/DescriptiveAccessMetadata"
        relatedResource:
          description: Other resources associated with the related resource.
          type: array
          items:
            $ref: "#/components/schemas/RelatedResource"
        adminMetadata:
          $ref: "#/components/schemas/DescriptiveAdminMetadata"
        version:
          description: The version of the related resource.
          type: string
        valueAt:
          description: URL or other pointer to the location of the related resource information.
          type: string
    ReleaseTag:
      description: A tag that indicates the item or collection should be released.
      type: object
      additionalProperties: false
      required:
        - release
      properties:
        who:
          description: Who did this release
          type: string
          example: petucket
        what:
          description: What is being released. This item or the whole collection.
          type: string
          enum:
            - self
            - collection
          example: self
        date:
          description: When did this action happen
          type: string
          format: date-time
        to:
          description: What platform is it released to
          type: string
          example: Searchworks
        release:
          type: boolean
    RequestAdministrative:
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/Administrative"
        - type: object
          additionalProperties: false
          properties:
            partOfProject:
              description: Internal project this resource is a part of. This governs routing of messages about this object.
              example: Google Books
              type: string
    RequestAdminPolicy:
      description: Same as an AdminPolicy, but doesn't have an externalIdentifier as one will be created
      type: object
      additionalProperties: false
      properties:
        cocinaVersion:
          $ref: '#/components/schemas/CocinaVersion'
        type:
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/admin_policy'
        label:
          type: string
        version:
          type: integer
          default: 1
          enum:
            - 1
        administrative:
          $ref: '#/components/schemas/AdminPolicyAdministrative'
        description:
          $ref: '#/components/schemas/RequestDescription'
      required:
        - cocinaVersion
        - administrative
        - label
        - type
        - version
    RequestCollection:
      description: Same as a Collection, but doesn't have an externalIdentifier as one will be created
      type: object
      additionalProperties: false
      properties:
        cocinaVersion:
          $ref: '#/components/schemas/CocinaVersion'
        type:
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/collection'
            - 'https://cocina.sul.stanford.edu/models/curated-collection'
            - 'https://cocina.sul.stanford.edu/models/user-collection'
            - 'https://cocina.sul.stanford.edu/models/exhibit'
            - 'https://cocina.sul.stanford.edu/models/series'
        label:
          type: string
        version:
          type: integer
          default: 1
          enum:
            - 1
        access:
          $ref: '#/components/schemas/CollectionAccess'
        administrative:
          $ref: '#/components/schemas/RequestAdministrative'
        description:
          $ref: '#/components/schemas/RequestDescription'
        identification:
          $ref: '#/components/schemas/CollectionIdentification'
      required:
        - cocinaVersion
        - access
        - administrative
        - label
        - type
        - version
    RequestDescription:
      description: Description that is included in a request to create a DRO. This is the same as a Description, except excludes PURL.
      type: object
      additionalProperties: false
      properties:
        title:
          description: Titles of the resource.
          type: array
          minItems: 1
          items:
            $ref: "#/components/schemas/Title"
        contributor:
          description: Agents contributing in some way to the creation and history of the
            resource.
          type: array
          items:
            $ref: "#/components/schemas/Contributor"
        event:
          description: Events in the history of the resource.
          type: array
          items:
            $ref: "#/components/schemas/Event"
        form:
          description: Characteristics of the resource's physical, digital, and intellectual
            form and genre, and of its process of creation.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        geographic:
          description: Geographic description for items with coordinates or bounding boxes.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveGeographicMetadata"
        language:
          description: Languages, scripts, symbolic systems, and notations used in all or
            part of a resource.
          type: array
          items:
            $ref: "#/components/schemas/Language"
        note:
          description: Additional information relevant to a resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        identifier:
          description: Identifiers and URIs associated with the resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        subject:
          description: Terms associated with the intellectual content of the resource.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        access:
          $ref: "#/components/schemas/DescriptiveAccessMetadata"
        relatedResource:
          description: Other resources associated with the described resource.
          type: array
          items:
            $ref: "#/components/schemas/RelatedResource"
        marcEncodedData:
          description: Data about the resource represented in MARC fixed fields and codes.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        adminMetadata:
          $ref: "#/components/schemas/DescriptiveAdminMetadata"
        valueAt:
          description: URL or other pointer to the location of the resource description.
          type: string
      required:
        - title
    RequestDRO:
      description: A request to create a DRO.  This has the same general structure as a DRO but doesn't have externalIdentifier and doesn't require the access subschema. If no access subschema is provided, these values will be inherited from the AdminPolicy.
      type: object
      additionalProperties: false
      properties:
        cocinaVersion:
          $ref: '#/components/schemas/CocinaVersion'
        type:
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/object'
            - 'https://cocina.sul.stanford.edu/models/3d'
            - 'https://cocina.sul.stanford.edu/models/agreement'
            - 'https://cocina.sul.stanford.edu/models/book'
            - 'https://cocina.sul.stanford.edu/models/document'
            - 'https://cocina.sul.stanford.edu/models/geo'
            - 'https://cocina.sul.stanford.edu/models/image'
            - 'https://cocina.sul.stanford.edu/models/page'
            - 'https://cocina.sul.stanford.edu/models/photograph'
            - 'https://cocina.sul.stanford.edu/models/manuscript'
            - 'https://cocina.sul.stanford.edu/models/map'
            - 'https://cocina.sul.stanford.edu/models/media'
            - 'https://cocina.sul.stanford.edu/models/track'
            - 'https://cocina.sul.stanford.edu/models/webarchive-binary'
            - 'https://cocina.sul.stanford.edu/models/webarchive-seed'
        label:
          type: string
        version:
          type: integer
          default: 1
          enum:
            - 1
        access:
          $ref: '#/components/schemas/DROAccess'
        administrative:
          $ref: '#/components/schemas/RequestAdministrative'
        description:
          $ref: '#/components/schemas/RequestDescription'
        identification:
          $ref: '#/components/schemas/RequestIdentification'
        structural:
          $ref: '#/components/schemas/RequestDROStructural'
        geographic:
          $ref: '#/components/schemas/Geographic'
      required:
        - cocinaVersion
        - administrative
        - identification
        - label
        - type
        - version
    RequestDROStructural:
      description: Structural metadata
      type: object
      additionalProperties: false
      properties:
        contains:
          type: array
          items:
            $ref: '#/components/schemas/RequestFileSet'
        hasMemberOrders:
          type: array
          items:
            $ref: '#/components/schemas/Sequence'
        isMemberOf:
          description: Collections that this DRO is a member of
          type: array
          items:
            $ref: '#/components/schemas/Druid'
    RequestFile:
      type: object
      additionalProperties: false
      properties:
        type:
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/file'
        label:
          type: string
        filename:
          type: string
        size:
          type: integer
        version:
          type: integer
        hasMimeType:
          type: string
        externalIdentifier:
          type: string
        use:
          type: string
        hasMessageDigests:
          type: array
          items:
            $ref: '#/components/schemas/MessageDigest'
        access:
          $ref: '#/components/schemas/FileAccess'
        administrative:
          $ref: '#/components/schemas/FileAdministrative'
        presentation:
          $ref: '#/components/schemas/Presentation'
      required:
        - label
        - type
        - version
        - filename
        - access
        - administrative
        - hasMessageDigests
    RequestFileSet:
      type: object
      additionalProperties: false
      properties:
        type:
          type: string
          enum:
            - 'https://cocina.sul.stanford.edu/models/resources/audio'
            - 'https://cocina.sul.stanford.edu/models/resources/attachment'
            - 'https://cocina.sul.stanford.edu/models/resources/document'
            - 'https://cocina.sul.stanford.edu/models/resources/file'
            - 'https://cocina.sul.stanford.edu/models/resources/image'
            - 'https://cocina.sul.stanford.edu/models/resources/main-augmented'
            - 'https://cocina.sul.stanford.edu/models/resources/main-original'
            - 'https://cocina.sul.stanford.edu/models/resources/media'
            - 'https://cocina.sul.stanford.edu/models/resources/object'
            - 'https://cocina.sul.stanford.edu/models/resources/page'
            - 'https://cocina.sul.stanford.edu/models/resources/permissions'
            - 'https://cocina.sul.stanford.edu/models/resources/preview'
            - 'https://cocina.sul.stanford.edu/models/resources/supplement'
            - 'https://cocina.sul.stanford.edu/models/resources/3d'
            - 'https://cocina.sul.stanford.edu/models/resources/thumb'
            - 'https://cocina.sul.stanford.edu/models/resources/video'
        label:
          type: string
        version:
          type: integer
        structural:
          $ref: '#/components/schemas/RequestFileSetStructural'
      required:
        - label
        - type
        - version
        - structural
    RequestFileSetStructural:
      description: Structural metadata
      type: object
      additionalProperties: false
      properties:
        contains:
          type: array
          items:
            $ref: '#/components/schemas/RequestFile'
    RequestIdentification:
      # Doesn't permit a DOI because our DOIs all use the DRUID as part of the DOI.
      # You have to register the object in order to get the DRUID before you can mint a DOI
      description: Same as a Identification, but requires a sourceId and doesn't permit a DOI.
      type: object
      additionalProperties: false
      properties:
        barcode:
          $ref: '#/components/schemas/Barcode'
        catalogLinks:
          type: array
          items:
            $ref: '#/components/schemas/CatalogLink'
        sourceId:
          $ref: '#/components/schemas/SourceId'
      required:
        - sourceId
    Sequence:
      description: A sequence or ordering of resources within a Collection or Object.
      type: object
      additionalProperties: false
      properties:
        members:
          description: "Identifiers for Members in their stated Order for the Sequence."
          type: array
          items:
            type: string
        viewingDirection:
          description: The direction that a sequence of canvases should be displayed to the user
          type: string
          enum:
            - right-to-left
            - left-to-right
    Source:
      description: Property model for indicating the vocabulary, authority, or
        other origin for a term, code, or identifier.
      type: object
      additionalProperties: false
      properties:
        code:
          description: Code representing the value source.
          type: string
        uri:
          description: URI for the value source.
          type: string
          format: uri
        value:
          description: String describing the value source.
          type: string
        note:
          description: Other information related to the value source.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        version:
          description: The version of the value source.
          type: string
    SourceId:
      type: string
      pattern: '^.+:.+$'
      description: >
        Unique identifier in some other system. This is because a large proportion of what is deposited in SDR,
        historically and currently, are representations of objects that are also represented in other systems.
        For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed
        in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers
        and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to
        look for the original item if you're looking at its SDR representation. The format is: "namespace:identifier"
      example: 'sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026'
    Standard:
      description: Property model for indicating the encoding, standard, or syntax
        to which a value conforms (e.g. RDA).
      type: object
      additionalProperties: false
      properties:
        code:
          description: Code representing the standard or encoding.
          type: string
        uri:
          description: URI for the standard or encoding.
          type: string
          format: uri
        value:
          description: String describing the standard or encoding.
          type: string
        note:
          description: Other information related to the standard or encoding.
          type: array
          items:
            $ref: "#/components/schemas/DescriptiveValue"
        version:
          description: The version of the standard or encoding.
          type: string
        source:
          $ref: "#/components/schemas/Source"
    StandardBarcode:
      description: The standard barcode associated with a DRO object, prefixed with 36105
      type: string
      nullable: true
      pattern: '^36105[0-9]{9}$'
      example: '36105010362304'
    Title:
      type: object
      additionalProperties: false
      allOf:
        - $ref: "#/components/schemas/DescriptiveValue"
        - anyOf:
            - type: object
              required:
                - value
            - type: object
              required:
                - structuredValue
            - type: object
              required:
                - parallelValue
            - type: object
              required:
                - groupedValue
            - type: object
              required:
                - valueAt
    StanfordAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          enum:
            - stanford
        download:
          description: Download access level.
          type: string
          enum:
            - stanford
        location:
          description: Not used for this access type, must be null.
          type: string
          nullable: true
          enum:
            - null
        controlledDigitalLending:
          type: boolean
          default: false
          enum:
            - false
      required:
        - view
        - download
    WorldAccess:
      type: object
      properties:
        view:
          description: Access level.
          type: string
          enum:
            - world
        download:
          description: Download access level.
          type: string
          enum:
            - none
            - stanford
            - world
        location:
          description: Not used for this access type, must be null.
          type: string
          nullable: true
          enum:
            - null
        controlledDigitalLending:
          type: boolean
          default: false
          enum:
            - false
      required:
        - view
        - download