swagger: "2.0"
host: festivals.tech
basePath: /api
info:
  version: 1.0.0
  title: festivals
tags:
  - name: news
    description: Operation about news
  - name: festivals
    description: Operation about festivals
  - name: festivals-events
    description: Operation about festival events
  - name: festivals-categories
    description: Operation about festival categories
  - name: festivals-places
    description: Operation about festival places
  - name: festivals-news
    description: Operation about festival news
schemes:
  - https
produces:
  - application/vnd.festivals.v1+json
  - application/vnd.festivals.v1+xml
security:
  - oauth2token:
    - public
paths:
  /news:
    get:
      tags:
        - news
      summary: Find news
      description: Get news collection
      operationId: getNewsCollection
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:get
      parameters:
        - name: name
          description: name
          required: false
          type: string
          in: query
        - name: updatedAt
          description: updatedAt
          required: false
          type: string
          in: query
        - name: limit
          description: limit
          required: false
          type: integer
          in: query
          default: 100
        - name: offset
          description: offset
          required: false
          type: integer
          in: query
        - name: country
          description: country
          required: false
          type: string
          in: query
        - name: sort
          description: sort
          required: false
          type: string
          in: query
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsCollectionResponse"
    post:
      tags:
        - news
      summary: Create news
      description: Create news
      operationId: createNews
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:create
      parameters:
        - in: body
          name: newsRequest
          description: News object
          required: true
          schema:
            $ref: "#/definitions/NewsRequest"
      responses:
        "201":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/news/{news.id}":
    get:
      tags:
        - news
      summary: Get news
      description: Get news
      operationId: getNews
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:get
      parameters:
        - name: id
          in: path
          description: News id
          required: true
          type: string
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsResponse"
        "404":
          description: News not found
    delete:
      tags:
        - news
      summary: Delete news
      description: Delete news
      operationId: deleteNews
      security:
        - oauth2token:
          - news:delete
      parameters:
        - name: id
          in: path
          description: News id
          required: true
          type: string
      responses:
        "204":
          description: successful operation
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: News not found
    put:
      tags:
        - news
      summary: Update news
      description: Update news
      operationId: updateNews
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:update
      parameters:
        - name: id
          in: path
          description: News id
          required: true
          type: string
        - in: body
          name: newsRequest
          description: News object
          required: true
          schema:
            $ref: "#/definitions/NewsRequest"
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: News not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  /festivals:
    get:
      tags:
        - festivals
      summary: Find festivals
      description: Get festivals collection
      operationId: getFestivals
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - festivals:get
      parameters:
        - name: name
          description: name
          required: false
          type: string
          in: query
        - name: description
          description: description
          required: false
          type: string
          in: query
        - name: type
          description: type
          required: false
          type: string
          default: FANTASY
          enum:
            - FANTASY
            - WOODSTOCK
            - MUSIC
          in: query
        - name: tag
          description: tag
          required: false
          type: string
          in: query
        - name: dateFrom
          description: dateFrom
          required: false
          type: string
          in: query
        - name: dateTo
          description: dateTo
          required: false
          type: string
          in: query
        - name: location.country
          description: location country
          required: false
          type: string
          in: query
        - name: location.name
          description: location name
          required: false
          type: string
          in: query
        - name: location.city
          description: location city
          required: false
          type: string
          in: query
        - name: location.state
          description: location state
          required: false
          type: string
          in: query
        - name: updatedAt
          description: updatedAt
          required: false
          type: string
          in: query
        - name: limit
          description: limit
          required: false
          type: integer
          in: query
          default: 100
        - name: offset
          description: offset
          required: false
          type: integer
          in: query
        - name: sort
          description: sort
          required: false
          type: string
          in: query
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/FestivalsCollectionResponse"
    post:
      tags:
        - festivals
      summary: Create festival
      description: Create festival
      operationId: createFestival
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - festivals:create
      parameters:
        - in: body
          name: festivalRequest
          description: Festival object
          required: true
          schema:
            $ref: "#/definitions/FestivalRequest"
      responses:
        "201":
          description: successful operation
          schema:
            $ref: "#/definitions/FestivalResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}":
    get:
      tags:
        - festivals
      summary: Get festival
      description: Get festival
      operationId: getFestival
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - festivals:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/FestivalResponse"
        "404":
          description: Festival not found
    delete:
      tags:
        - festivals
      summary: Delete festival
      description: Delete festival
      operationId: deleteFestival
      security:
        - oauth2token:
          - festivals:delete
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
      responses:
        "204":
          description: successful operation
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
    put:
      tags:
        - festivals
      summary: Update festival
      description: Update festival
      operationId: updateFestival
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - festivals:update
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - in: body
          name: festivalRequest
          description: Festival object
          required: true
          schema:
            $ref: "#/definitions/FestivalRequest"
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/FestivalResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Festival not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/events":
    get:
      tags:
        - festivals-events
      summary: Get festival events
      description: Get festival events collection
      operationId: getFestivalEvents
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - events:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: name
          description: name
          required: false
          type: string
          in: query
        - name: description
          description: description
          required: false
          type: string
          in: query
        - name: place.name
          description: place name
          required: false
          type: string
          in: query
        - name: category.name
          description: category name
          required: false
          type: string
          in: query
        - name: dateFrom
          description: dateFrom
          required: false
          type: string
          in: query
        - name: dateTo
          description: dateTo
          required: false
          type: string
          in: query
        - name: author.name
          description: author name
          required: false
          type: string
          in: query
        - name: author.organization
          description: author organization
          required: false
          type: string
          in: query
        - name: updatedAt
          description: updatedAt
          required: false
          type: string
          in: query
        - name: limit
          description: limit
          required: false
          type: integer
          in: query
          default: 100
        - name: offset
          description: offset
          required: false
          type: integer
          in: query
        - name: sort
          description: sort
          required: false
          type: string
          in: query
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/EventsCollectionResponse"
        "404":
          description: Not found
    post:
      tags:
        - festivals-events
      summary: Create festival events
      description: Create festival events
      operationId: createFestivalEvent
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - events:create
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - in: body
          name: festivalEventRequest
          description: Festival event object
          required: true
          schema:
            $ref: "#/definitions/EventRequest"
      responses:
        "201":
          description: successful operation
          schema:
            $ref: "#/definitions/EventResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Festival not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/events/{event.id}":
    get:
      tags:
        - festivals-events
      summary: Get festival event
      description: Get festival event collection
      operationId: getFestivalEvent
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - events:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: event.id
          in: path
          description: Event id
          required: true
          type: string
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/EventResponse"
    delete:
      tags:
        - festivals-events
      summary: Delete festival event
      description: Delete festival events
      operationId: deleteFestivalEvent
      security:
        - oauth2token:
          - events:delete
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: event.id
          in: path
          description: Event id
          required: true
          type: string
      responses:
        "204":
          description: successful operation
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
    put:
      tags:
        - festivals-events
      summary: Update festival events
      description: Update festival events
      operationId: updateFestivalEvent
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - events:update
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: event.id
          in: path
          description: Event id
          required: true
          type: string
        - in: body
          name: festivalEventRequest
          description: Festival event object
          required: true
          schema:
            $ref: "#/definitions/EventRequest"
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/EventResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/categories":
    get:
      tags:
        - festivals-categories
      summary: Get festival categories
      description: Get festival categories collection
      operationId: getFestivalCategories
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - categories:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: updatedAt
          description: updatedAt
          required: false
          type: string
          in: query
        - name: parent.id
          description: category parent id
          required: false
          type: string
          in: query
        - name: name
          description: name
          required: false
          type: string
          in: query
        - name: limit
          description: limit
          required: false
          type: integer
          in: query
          default: 100
        - name: offset
          description: offset
          required: false
          type: integer
          in: query
        - name: sort
          description: sort
          required: false
          type: string
          in: query
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/CategoriesCollectionResponse"
        "404":
          description: Festival not found
    post:
      tags:
        - festivals-categories
      summary: Create festival category
      description: Create festival category
      operationId: createFestivalCategory
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - categories:create
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - in: body
          name: festivalCategoryRequest
          description: Festival category object
          required: true
          schema:
            $ref: "#/definitions/CategoryRequest"
      responses:
        "201":
          description: successful operation
          schema:
            $ref: "#/definitions/CategoryResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Festival not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/categories/{category.id}":
    get:
      tags:
        - festivals-categories
      summary: Get festival category
      description: Get festival category
      operationId: getFestivalCategory
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - categories:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: category.id
          in: path
          description: Category id
          required: true
          type: string
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/CategoryResponse"
        "404":
          description: Not found
    delete:
      tags:
        - festivals-categories
      summary: Delete festival category
      description: Delete festival category
      operationId: deleteFestivalCategory
      security:
        - oauth2token:
          - categories:delete
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: category.id
          in: path
          description: Category id
          required: true
          type: string
      responses:
        "204":
          description: successful operation
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
    put:
      tags:
        - festivals-categories
      summary: Update festival category
      description: Update festival category
      operationId: updateFestivalCategory
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - categories:update
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: category.id
          in: path
          description: Category id
          required: true
          type: string
        - in: body
          name: festivalCategoryRequest
          description: Festival category object
          required: true
          schema:
            $ref: "#/definitions/CategoryRequest"
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/CategoryResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/places":
    get:
      tags:
        - festivals-places
      summary: Get festival places
      description: Get festival places collection
      operationId: getFestivalPlaces
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - places:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: updatedAt
          description: updatedAt
          required: false
          type: string
          in: query
        - name: parent.id
          description: place parent id
          required: false
          type: string
          in: query
        - name: name
          description: name
          required: false
          type: string
          in: query
        - name: limit
          description: limit
          required: false
          type: integer
          in: query
          default: 100
        - name: offset
          description: offset
          required: false
          type: integer
          in: query
        - name: sort
          description: sort
          required: false
          type: string
          in: query
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/PlacesCollectionResponse"
        "404":
          description: Festival not found
    post:
      tags:
        - festivals-places
      summary: Create festival place
      description: Create festival place
      operationId: createFestivalPlace
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - places:create
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - in: body
          name: festivalPlaceRequest
          description: Festival place object
          required: true
          schema:
            $ref: "#/definitions/PlaceRequest"
      responses:
        "201":
          description: successful operation
          schema:
            $ref: "#/definitions/PlaceResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/places/{place.id}":
    get:
      tags:
        - festivals-places
      summary: Get festival place
      description: Get festival place
      operationId: getFestivalPlace
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - places:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: place.id
          in: path
          description: Place id
          required: true
          type: string
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/PlaceResponse"
        "404":
          description: Festival not found
    delete:
      tags:
        - festivals-places
      summary: Delete festival place
      description: Delete festival place
      operationId: deleteFestivalPlace
      security:
        - oauth2token:
          - places:delete
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: place.id
          in: path
          description: Place id
          required: true
          type: string
      responses:
        "204":
          description: successful operation
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
    put:
      tags:
        - festivals-places
      summary: Update festival place
      description: Update festival place
      operationId: updateFestivalPlace
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - places:update
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: place.id
          in: path
          description: Place id
          required: true
          type: string
        - in: body
          name: festivalPlaceRequest
          description: Festival place object
          required: true
          schema:
            $ref: "#/definitions/PlaceRequest"
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/PlaceResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/news":
    get:
      tags:
        - festivals-news
      summary: Find festival news
      description: Get festival news collection
      operationId: getFestivalNewsCollection
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: name
          description: name
          required: false
          type: string
          in: query
        - name: updatedAt
          description: updatedAt
          required: false
          type: string
          in: query
        - name: limit
          description: limit
          required: false
          type: integer
          in: query
          default: 100
        - name: offset
          description: offset
          required: false
          type: integer
          in: query
        - name: sort
          description: sort
          required: false
          type: string
          in: query
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsCollectionResponse"
    post:
      tags:
        - festivals-news
      summary: Create festival news
      description: Create festival news
      operationId: createFestivalNews
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:create
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - in: body
          name: newsRequest
          description: News object
          required: true
          schema:
            $ref: "#/definitions/NewsRequest"
      responses:
        "201":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
  "/festivals/{id}/news/{news.id}":
    get:
      tags:
        - festivals-news
      summary: Get festival news
      description: Get festival news
      operationId: getFestivalNews
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:get
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: news.id
          in: path
          description: News id
          required: true
          type: string
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsResponse"
        "404":
          description: News not found
    delete:
      tags:
        - festivals-news
      summary: Delete festival news
      description: Delete festival news
      operationId: deleteFestivalNews
      security:
        - oauth2token:
          - news:delete
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: news.id
          in: path
          description: News id
          required: true
          type: string
      responses:
        "204":
          description: successful operation
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: News not found
    put:
      tags:
        - festivals-news
      summary: Update festival news
      description: Update festival news
      operationId: updateFestivalNews
      consumes:
        - application/vnd.festivals.v1+json
      produces:
        - application/vnd.festivals.v1+json
      security:
        - oauth2token:
          - news:update
      parameters:
        - name: id
          in: path
          description: Festival id
          required: true
          type: string
        - name: news.id
          in: path
          description: News id
          required: true
          type: string
        - in: body
          name: newsRequest
          description: News object
          required: true
          schema:
            $ref: "#/definitions/NewsRequest"
      responses:
        "200":
          description: successful operation
          schema:
            $ref: "#/definitions/NewsResponse"
        "400":
          description: Bad request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: News not found
        "406":
          description: The request you made is not acceptable
        "422":
          description: Invalid parameter value
securityDefinitions:
  oauth2token:
    type: oauth2
    flow: implicit
    authorizationUrl: https://vehicle-history.io/oauth/authorization
    scopes:
      public: public API scope
      news:update: permission to update news
      news:delete: permission to delete news
      news:get: permission to get news
      news:create: permission to create news
      places:update: permission to update places
      places:delete: permission to delete places
      places:get: permission to get places
      places:create: permission to create places
      categories:update: permission to update categories
      categories:delete: permission to delete categories
      categories:get: permission to get categories
      categories:create: permission to create categories
      events:update: permission to update events
      events:delete: permission to delete events
      events:get: permission to get events
      events:create: permission to create events
      festivals:update: permission to update festivals
      festivals:delete: permission to delete festivals
      festivals:get: permission to get festivals
      festivals:create: permission to create festivals
definitions:
  CoordinatesRequest:
    properties:
      lat:
        type: number
        format: double
        description: lat
      lon:
        type: number
        format: double
        description: lon
    description: Geo coordinates
    required:
      - lat
      - lon
  CoordinatesResponse:
    properties:
      lat:
        type: number
        format: double
        description: lat
      lon:
        type: number
        format: double
        description: lon
    description: Geo coordinates
    required:
      - lat
      - lon
  AuthorResponse:
    properties:
      name:
        type: string
        description: name
      organization:
        type: string
        description: organization
    description: Author
    required:
      - name
      - organization
  AuthorRequest:
    properties:
      name:
        type: string
        description: name
      organization:
        type: string
        description: organization
    description: Author
    required:
      - name
      - organization
  DurationResponse:
    properties:
      startAt:
        type: string
        description: start at
      finishAt:
        type: string
        description: finish at
      periodMs:
        type: integer
        description: periodMs
    description: Duration response
    required:
      - startAt
      - finishAt
      - periodMs
  DurationRequest:
    properties:
      startAt:
        type: string
        description: start at
      finishAt:
        type: string
        description: finish at
    description: Duration request
    required:
      - startAt
      - finishAt
  LocationResponse:
    properties:
      name:
        type: string
        description: Location name
      state:
        type: string
        description: Location state
      country:
        type: integer
        description: Location country
      street:
        type: string
        description: Location street
      city:
        type: string
        description: Location city
      zip:
        type: string
        description: Location zip
      openingTimes:
        type: array
        description: Location opening times
        items:
          $ref: "#/definitions/DurationResponse"
      coordinates:
        $ref: "#/definitions/CoordinatesResponse"
        description: Coordinates
    description: Festival response
    required:
      - name
      - state
      - country
      - street
      - openingTimes
  LocationRequest:
    properties:
      name:
        type: string
        description: Location name
      state:
        type: string
        description: Location state
      country:
        type: integer
        description: Location country
      street:
        type: string
        description: Location street
      city:
        type: string
        description: Location city
      zip:
        type: string
        description: Location zip
      openingTimes:
        type: array
        description: Location opening times
        items:
          $ref: "#/definitions/DurationRequest"
      coordinates:
        $ref: "#/definitions/CoordinatesRequest"
        description: Coordinates
    description: Festival response
    required:
      - name
      - state
      - country
      - street
      - openingTimes
  MainImageResponse:
    properties:
      small:
        type: string
        description: Image small url
      medium:
        type: string
        description: Image medium url
      large:
        type: string
        description: Image large url
    description: Festival response
  ImageRequest:
    properties:
      url:
        type: string
        description: Image url
      content:
        type: string
        description: Image content
      order:
        type: integer
        description: Image order
    description: Festival response
    required:
      - order
  PlaceResponse:
    properties:
      id:
        type: string
        description: Festival place id
      name:
        type: string
        description: Festival place name
      parent:
        type: string
        description: Festival place parent
      openingTimes:
        type: array
        description: Festival place opening times
        items:
          $ref: "#/definitions/DurationResponse"
      coordinates:
        $ref: "#/definitions/CoordinatesResponse"
        description: Coordinates
      mainImage:
        $ref: "#/definitions/MainImageResponse"
        description: Event main image
      createdAt:
        type: string
        description: Festival place createdAt
      updatedAt:
        type: string
        description: Festival place updatedAt
    description: Festival response
    required:
      - id
      - name
      - parent
      - openingTimes
      - createdAt
      - updatedAt
  PlaceRequest:
    properties:
      name:
        type: string
        description: Festival place name
      parent:
        type: string
        description: Festival place parent
      openingTimes:
        type: array
        description: Festival place opening times
        items:
          $ref: "#/definitions/DurationRequest"
      coordinates:
        $ref: "#/definitions/CoordinatesRequest"
        description: Coordinates
      images:
        type: array
        items:
          $ref: "#/definitions/ImageRequest"
        description: Images
    description: Festival response
    required:
      - name
      - parent
      - openingTimes
      - images
  EventPlaceResponse:
    properties:
      id:
        type: string
        description: Place id
      name:
        type: string
        description: Place name
      breadcrumbs:
        type: array
        description: Place breadcrumbs
        items:
          $ref: "#/definitions/PlaceResponse"
      openingTimes:
        type: array
        description: Place opening times
        items:
          $ref: "#/definitions/DurationResponse"
      coordinates:
        $ref: "#/definitions/CoordinatesResponse"
        description: Coordinates
    description: Festival response
    required:
      - id
      - name
      - breadcrumbs
      - openingTimes
  CategoryRequest:
    properties:
      parent:
        type: string
        description: Festival category parent id
      name:
        type: string
        description: Festival category name
    description: Festival category request
    required:
      - parent
      - name
  CategoryResponse:
    properties:
      id:
        type: string
        description: Category id
      name:
        type: string
        description: Category name
      parent:
        type: string
        description: Category parent
      createdAt:
        type: string
        description: Category createdAt
      updatedAt:
        type: string
        description: Category updatedAt
    description: Festival category response
    required:
      - id
      - name
      - parent
      - createdAt
      - updatedAt
  EventCategoryResponse:
    properties:
      id:
        type: string
        description: Event category id
      name:
        type: string
        description: Event category name
      breadcrumbs:
        type: array
        description: Event category breadcrumbs
        items:
          $ref: "#/definitions/CategoryResponse"
    description: Festival category response
    required:
      - id
      - name
      - breadcrumbs
  EventRequest:
    properties:
      name:
        type: string
        description: Event name
      description:
        type: string
        description: Event description
      tags:
        type: array
        items:
          type: string
        description: Event tags
      status:
        type: string
        description: Status of event
        default: CREATED
        enum:
          - CREATED
          - PUBLISHED
          - CANCELED
          - MOVED
      metadata:
        type: array
        items:
          type: string
        description: Event metadata
      images:
        type: array
        items:
          $ref: "#/definitions/ImageRequest"
        description: Event images
      duration:
        $ref: "#/definitions/DurationRequest"
        description: Event duration
      place:
        type: string
        description: Event place
      category:
        type: string
        description: Event category
      authors:
        type: array
        items:
          $ref: "#/definitions/AuthorRequest"
        description: Event authors
    description: Event request
    required:
      - name
      - description
      - duration
      - place
      - category
  EventResponse:
    properties:
      id:
        type: string
        description: Event id
      name:
        type: string
        description: Event name
      description:
        type: string
        description: Event description
      tags:
        type: array
        items:
          type: string
        description: Event tags
      status:
        type: string
        description: Status of event
        default: CREATED
        enum:
          - CREATED
          - PUBLISHED
          - CANCELED
          - MOVED
      mainImage:
        $ref: "#/definitions/MainImageResponse"
        description: Event main image
      duration:
        $ref: "#/definitions/DurationResponse"
        description: Event duration
      place:
        $ref: "#/definitions/EventPlaceResponse"
        description: Event place
      category:
        $ref: "#/definitions/EventCategoryResponse"
        description: Event category
      authors:
        type: array
        items:
          $ref: "#/definitions/AuthorResponse"
        description: Event authors
      publishedAt:
        type: string
        description: Event publishedAt
      createdAt:
        type: string
        description: Event createdAt
      updatedAt:
        type: string
        description: Event updatedAt
    description: Event response
    required:
      - id
      - name
      - description
      - duration
      - place
      - category
      - publishedAt
      - createdAt
      - updatedAt
  FestivalResponse:
    properties:
      id:
        type: string
        description: Festival id
      name:
        type: string
        description: Festival name
      description:
        type: string
        description: Festival description
      type:
        type: string
        description: Festival type
        enum:
          - FANTASY
          - WOODSTOCK
          - MUSIC
      status:
        type: string
        description: Status of festival
        enum:
          - CREATED
          - PUBLISHED
          - CANCELED
      tags:
        type: array
        items:
          type: string
        description: Festival tags
      mainImage:
        $ref: "#/definitions/MainImageResponse"
        description: Festival main image
      duration:
        $ref: "#/definitions/DurationResponse"
        description: Festival duration
      locations:
        type: array
        description: Festival locations
        items:
          $ref: "#/definitions/LocationResponse"
      publishedAt:
        type: string
        description: Festival publishedAt
      createdAt:
        type: string
        description: Festival createdAt
      updatedAt:
        type: string
        description: Festival updatedAt
    description: Festival response
    required:
      - id
      - name
      - description
      - type
      - status
      - locations
      - duration
      - publishedAt
      - createdAt
      - updatedAt
  FestivalRequest:
    properties:
      name:
        type: string
        description: Festival name
      description:
        type: string
        description: Festival description
      type:
        type: string
        description: Festival type
        default: FANTASY
        enum:
          - FANTASY
          - WOODSTOCK
          - MUSIC
      status:
        type: string
        description: Status of festival
        default: CREATED
        enum:
          - CREATED
          - PUBLISHED
          - CANCELED
      tags:
        type: array
        items:
          type: string
        description: Festival tags
      images:
        type: array
        items:
          $ref: "#/definitions/ImageRequest"
        description: Festival images
      duration:
        $ref: "#/definitions/DurationRequest"
        description: Festival duration
      locations:
        type: array
        description: Festival locations
        items:
          $ref: "#/definitions/LocationRequest"
    description: Festival request
    required:
      - name
      - description
      - type
      - duration
      - locations
  FestivalsCollectionResponse:
    properties:
      total:
        type: integer
        description: Total festivals
      festivals:
        type: array
        items:
          $ref: "#/definitions/FestivalResponse"
    description: Festivals collection
    required:
      - total
      - festivals
  EventsCollectionResponse:
    properties:
      total:
        type: integer
        description: Total festival events
      events:
        type: array
        items:
          $ref: "#/definitions/EventResponse"
    description: Events collection
    required:
      - total
      - events
  CategoriesCollectionResponse:
    properties:
      total:
        type: integer
        description: Total festival categories
      categories:
        type: array
        items:
          $ref: "#/definitions/CategoryResponse"
    description: Festival categories collection
    required:
      - total
      - categories
  PlacesCollectionResponse:
    properties:
      total:
        type: integer
        description: Total festival places
      places:
        type: array
        items:
          $ref: "#/definitions/PlaceResponse"
    description: Festival places collection
    required:
      - total
      - places
  NewsResponse:
    properties:
      id:
        type: string
        description: News id
      name:
        type: string
        description: News name
      description:
        type: string
        description: News description
      status:
        type: string
        description: Status of news
        default: CREATED
        enum:
          - CREATED
          - PUBLISHED
          - CANCELED
      mainImage:
        $ref: "#/definitions/MainImageResponse"
        description: Main image
      authors:
        type: array
        items:
          $ref: "#/definitions/AuthorResponse"
        description: Event authors
      tags:
        type: array
        items:
          type: string
        description: News tags
      publishedAt:
        type: string
        description: News publishedAt
      createdAt:
        type: string
        description: News createdAt
      updatedAt:
        type: string
        description: News updatedAt
    description: News response
    required:
      - id
      - name
      - description
      - status
      - mainImage
      - tags
      - createdAt
      - updatedAt
  NewsRequest:
    properties:
      name:
        type: string
        description: News name
      description:
        type: string
        description: News description
      status:
        type: string
        description: Status of event
        default: CREATED
        enum:
          - CREATED
          - PUBLISHED
          - CANCELED
      images:
        type: array
        items:
          $ref: "#/definitions/ImageRequest"
        description: Images
      authors:
        type: array
        items:
          $ref: "#/definitions/AuthorRequest"
        description: Event authors
      tags:
        type: array
        items:
          type: string
        description: News tags
    description: News request
    required:
      - name
      - description
      - images
      - tags
  NewsCollectionResponse:
    properties:
      total:
        type: integer
        description: Total news collection
      news:
        type: array
        items:
          $ref: "#/definitions/NewsResponse"
    description: News collection
    required:
      - total
      - news