festivals

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