components:
  schemas:
    OrganizationBase:
      allOf:
        - $ref: ../permission_bound.yaml#/components/schemas/PermissionBound
        - $ref: ../common/describable.yaml#/components/schemas/Describable
        - type: object
          additionalProperties: false
          required:
            - timeZone
          properties:
            tenantRef:
              description: Tenant identifier that owns the organization.
              $ref: ../objectid.yaml#/components/schemas/ObjectId
            timeZone:
              type: string
            logoUrl:
              type: string
              nullable: true
            signupState:
              description: Signup/provisioning lifecycle state for the organization.
              type: string
              enum:
                - pending_signup_provisioning
                - blocked_signup_provisioning
                - active

    Organization:
      allOf:
        - $ref: ./organization.yaml#/components/schemas/OrganizationBase
        - type: object
          additionalProperties: false
          required:
            - members
          properties:
            members:
              type: array
              items:
                $ref: ../objectid.yaml#/components/schemas/ObjectId