---
url: "https://developer-qual.migros.ch/apis/content-search-api-qual-v1/versions/169d9ab2-7072-4f6f-811a-fff1e6bc0086"
---

OpenAPI specification document.

```json
{"components":{"requestBodies":{"ContentSearch_AutocompleteMigustoArticlesBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticlesRequest"}]}}},"required":true},"ContentSearch_SearchContenthubNewsTeaserBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchSearchContenthubNewsTeaserRequest"}]}}},"required":true},"ContentSearch_SearchCorporateStoriesBody":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchSearchCorporateStoriesRequest"}]}}},"required":true}},"schemas":{"ImagePoint":{"properties":{"x":{"format":"int64","type":"string"},"y":{"format":"int64","type":"string"}},"type":"object"},"consolcontentsearchContact":{"properties":{"address":{"description":"Physical address of the contact.","type":"string"},"company":{"description":"Name of the company associated with the contact.","type":"string"},"description":{"description":"Description of the contact.","type":"string"},"email":{"description":"Email address for the contact.","type":"string"},"function":{"description":"Function of the contact.","type":"string"},"image":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"description":"Image associated with the contact."},"mobile":{"description":"Mobile phone number for the contact.","type":"string"},"phone":{"description":"Phone number for the contact.","type":"string"},"title":{"description":"Title of the contact.","type":"string"}},"type":"object"},"consolcontentsearchContenthubNews":{"description":"A message representing a 'detail view' of a news item.","properties":{"contacts":{"description":"Optional. List of contacts related to the news item.","items":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchContact"}],"type":"object"},"type":"array"},"content":{"description":"Required. Full content of the news item.","type":"string"},"downloads":{"description":"Optional. List of downloadable items related to the news item.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchDownload"}],"type":"object"},"type":"array"},"id":{"description":"Required. An opaque system ID.","type":"string"},"image":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"description":"Required. URL for the main image of the news item."},"intro":{"description":"Required. Introductory text for the news item.","type":"string"},"publishedTimestamp":{"description":"Required. Timestamp when the news item was published.","format":"date-time","type":"string"},"region":{"description":"Required. The region for the news item.","type":"string"},"shortTitle":{"description":"Required. Short title of the news item.","type":"string"},"slug":{"description":"Required. The slug of this news item.","type":"string"},"tags":{"description":"Required. Tags for this news item.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchCategoryTag"}],"type":"object"},"type":"array"},"title":{"description":"Required. The title of this news item.","type":"string"},"translationAvailable":{"description":"Required. Indicates if translations are available.","type":"boolean"}},"type":"object"},"consolcontentsearchMigustoArticle":{"properties":{"content":{"title":"Required. Content (teaser text) of the article","type":"string"},"hasVideo":{"description":"Required. Indicates whether the article has a stage video.","type":"boolean"},"highlight":{"title":"Optional. Titles with highlighted title fragments for search term matches.\nOnly present for autocomplete searches\nExample: \"Die beliebtesten Eigenmarken: Typisch <b>Migros</b>\"","type":"string"},"id":{"title":"Required. ID of the article","type":"string"},"image":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"title":"Required. Image of the article"},"slug":{"description":"Required. The slug used to build the article detail route.","type":"string"},"tags":{"items":{"allOf":[{"$ref":"#/components/schemas/contentsearchCategoryTag"}],"type":"object"},"title":"Required. Tags of the article","type":"array"},"title":{"title":"Required. Title of the article","type":"string"},"updatedAt":{"format":"date-time","title":"Required. UpdatedAt timestamp of the article","type":"string"}},"type":"object"},"consolcontentsearchNews":{"properties":{"contacts":{"description":"Optional. List of contacts related to the news item.","items":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchContact"}],"type":"object"},"type":"array"},"content":{"description":"Required. Full content of the news item.","type":"string"},"downloads":{"description":"Optional. List of downloadable items related to the news item.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchDownload"}],"type":"object"},"type":"array"},"id":{"description":"Required. An opaque system ID.","type":"string"},"image":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"description":"Required. URL for the main image of the news item."},"intro":{"description":"Required. Introductory text for the news item.","type":"string"},"publishedTimestamp":{"description":"Required. Timestamp when the news item was published.","format":"date-time","type":"string"},"region":{"description":"Required. The region for the news item.","type":"string"},"shortTitle":{"description":"Required. Short title of the news item.","type":"string"},"slug":{"description":"Required. The slug of this news item.","type":"string"},"tags":{"description":"Required. Tags for this news item.","items":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchTag"}],"type":"object"},"type":"array"},"title":{"description":"Required. The title of this news item.","type":"string"},"translationAvailable":{"description":"Required. Indicates if translations are available.","type":"boolean"}},"type":"object"},"consolcontentsearchTag":{"properties":{"id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"contentsearchCategoryTag":{"properties":{"category":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"type":"object"},"contentsearchCategoryTagWithCount":{"properties":{"count":{"format":"int64","type":"string"},"tag":{"allOf":[{"$ref":"#/components/schemas/contentsearchCategoryTag"}]}},"type":"object"},"contentsearchContentHubNewsResponse":{"description":"Response to an attempt to retrieve a Contenthub news item either by its slug\nor by its ID.","properties":{"news":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchContenthubNews"}],"description":"Optional. The news item with the requested slug or ID."}},"type":"object"},"contentsearchContenthubNewsTeaser":{"properties":{"highlight":{"title":"Optional. Titles with highlighted title fragments for search term matches.\nOnly present for autocomplete searches\nExample: \"Die beliebtesten Eigenmarken: Typisch <b>Migros</b>\"","type":"string"},"id":{"title":"Required. ID of the article","type":"string"},"intro":{"description":"Required.","type":"string"},"region":{"description":"Optional. The region for the news item.","type":"string"},"releaseDate":{"description":"The time the content was published.\n\nContent taken from the news item itself.","format":"date-time","type":"string"},"slug":{"description":"Required. The slug of this news item.","type":"string"},"tags":{"items":{"allOf":[{"$ref":"#/components/schemas/contentsearchCategoryTag"}],"type":"object"},"title":"Required. Tags of the article","type":"array"},"title":{"description":"Required. The title of this news item.","type":"string"},"titleImage":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"title":"Required. Image of the article"},"translationAvailable":{"description":"Wenn translationAvailable = false it means that this teaser in the\nrequested language has been chosen through language fallbacks, and\nhence has not explicitly maintained in this language in Contentful.","type":"boolean"}},"title":"ContenthubNewsTeaser represents the teaser of a news item from contenthub\nand is stored in the Contenthub Contentful Space with the ID: 0y25wr71xvc0.\nhttps://app.contentful.com/spaces/0y25wr71xvc0/environments/staging/views/entries","type":"object"},"contentsearchCorporateStory":{"properties":{"content":{"description":"Required.","type":"string"},"id":{"title":"Required. ID of the story","type":"string"},"releaseDate":{"description":"The time the content was published.","format":"date-time","type":"string"},"slug":{"description":"The story's slug.","type":"string"},"tags":{"items":{"allOf":[{"$ref":"#/components/schemas/contentsearchCategoryTag"}],"type":"object"},"title":"Required. Tags of the story","type":"array"},"teaserImage":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"title":"Required. Teaser image of the story"},"title":{"description":"Required. The title of this story.","type":"string"},"titleImage":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"title":"Required. Title image of the story"},"topic":{"description":"Topic / \"Dachzeile\" of the story teaser.\n\nContent taken from the story itself.","type":"string"}},"title":"Story represents a story published to Migros corporate websites\nand is stored in the Corporate Contentful Space with the ID: ra41rfif8mpw.\nhttps://app.contentful.com/spaces/ra41rfif8mpw/environments/staging/views/entries","type":"object"},"contentsearchDownload":{"properties":{"filename":{"description":"Original filename of the downloadable file.","type":"string"},"mimeType":{"description":"MIME type of the downloadable file, e.g., \"application/pdf\" or \"image/png\".","type":"string"},"size":{"description":"Size of the file in bytes.","format":"uint64","type":"string"},"title":{"description":"Title of the downloadable item.","type":"string"},"url":{"description":"URL where the downloadable file can be accessed.","type":"string"}},"type":"object"},"contentsearchHealthResponse":{"properties":{"info":{"description":"Provides info to the current health state, e.g. \"UP\".","type":"string"}},"type":"object"},"contentsearchImage":{"properties":{"altText":{"type":"string"},"caption":{"type":"string"},"credits":{"type":"string"},"focalPoint":{"allOf":[{"$ref":"#/components/schemas/ImagePoint"}]},"height":{"format":"int64","type":"string"},"id":{"type":"string"},"mimeType":{"type":"string"},"shortCaption":{"type":"string"},"url":{"type":"string"},"width":{"format":"int64","type":"string"}},"type":"object"},"contentsearchLanguage":{"default":"DE","enum":["DE","FR","IT","EN"],"title":"Languages which can be filtered","type":"string"},"contentsearchListNewsTeaserResponse":{"properties":{"news":{"description":"Optional. If news items matching the requested criteria were found, they're\nin here. The returned order is arbitrary.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchNewsTeaser"}],"type":"object"},"type":"array"},"totalHits":{"description":"Total number of news items for this request, not taking page_size into\naccount.","format":"int64","type":"string"}},"type":"object"},"contentsearchListStoriesResponse":{"properties":{"stories":{"description":"Optional. If new items matching the requested criteria were found, they're\nin here. The returned order is arbitrary.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchStory"}],"type":"object"},"type":"array"},"totalHits":{"description":"Total number of stories for this request, not taking page_size into\naccount.","format":"int64","type":"string"}},"type":"object"},"contentsearchMigustoArticleResponse":{"properties":{"article":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchMigustoArticle"}],"description":"Optional. The article matching the requested criteria."}},"type":"object"},"contentsearchMigustoArticlesRequest":{"properties":{"doNotMatch":{"description":"Optional. Terms not to be matched, multiple terms will be combined with an\n\"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTerm"}],"type":"object"},"type":"array"},"language":{"allOf":[{"$ref":"#/components/schemas/contentsearchLanguage"}],"title":"Required. Which language of the articles should be searched"},"match":{"description":"Optional. Terms to be matched, multiple terms will be combined with an\n\"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTerm"}],"type":"object"},"type":"array"},"options":{"allOf":[{"$ref":"#/components/schemas/contentsearchOutputOptions"}],"description":"Optional. OutputOptions for pagination and sorting."},"searchTerm":{"description":"Optional. Search Term for fulltext-search.","type":"string"},"timeTerms":{"description":"Optional. Time terms to be matched, multiple time terms will be combined\nwith an \"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTimeTerm"}],"type":"object"},"type":"array"}},"type":"object"},"contentsearchMigustoArticlesResponse":{"properties":{"articles":{"description":"Optional. If articles matching the requested criteria were found, they're\nin here.","items":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchMigustoArticle"}],"type":"object"},"type":"array"},"totalHits":{"description":"Total number of articles for this request, not taking page_size into\naccount.","format":"int64","type":"string"}},"type":"object"},"contentsearchNewsResponse":{"properties":{"news":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchNews"}],"description":"Optional. The news item matching the requested criteria."}},"type":"object"},"contentsearchNewsTeaser":{"description":"News currently represents a \"Medienmitteilung\" or a \"Warenrueckruf\".","properties":{"content":{"description":"Required.","type":"string"},"id":{"description":"Required. An opaque system ID.","type":"string"},"images":{"description":"Optional. Any images that are part of this content.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"type":"object"},"type":"array"},"publishedTimestamp":{"description":"The time the content was published. Disregard if published = false.","format":"date-time","type":"string"},"region":{"description":"Optional. The region for the news item.","type":"string"},"slug":{"description":"Required. The 'slug' or internal short ID of this news item.","type":"string"},"tags":{"description":"Tags for this news item.","items":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchTag"}],"type":"object"},"type":"array"},"title":{"description":"Required. The title of this news item.","type":"string"},"topic":{"description":"Required.","type":"string"},"translationAvailable":{"description":"Required.","type":"boolean"}},"type":"object"},"contentsearchOutputOptions":{"properties":{"nextPageFrom":{"format":"int64","title":"Optional. An offset into the elasticsearch response from where news should\nbe returned, e.g. 6","type":"string"},"pageSize":{"description":"Optional. The maximum number of items to return in the response.","format":"int64","type":"string"},"sortBy":{"description":"Optional. A list of sort parameters to determine the order of the results.\nExample: [\"updatedAt:desc\", \"_score:desc\"].\nEach entry specifies a field and its sort direction (asc/desc).","items":{"type":"string"},"type":"array"}},"title":"OutputOptions configures pagination and sorting","type":"object"},"contentsearchReadyResponse":{"properties":{"elasticsearch":{"description":"Provides information on whether Elasticsearch is UP.","type":"string"}},"type":"object"},"contentsearchRefreshResponse":{"properties":{"info":{"description":"Provides information about the result of the refresh operation.","type":"string"}},"type":"object"},"contentsearchSearchContenthubNewsTeaserRequest":{"properties":{"doNotMatch":{"description":"Optional. Terms not to be matched, multiple terms will be combined with an\n\"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTerm"}],"type":"object"},"type":"array"},"language":{"allOf":[{"$ref":"#/components/schemas/contentsearchLanguage"}],"description":"Optional. If set, only news matching this language will be returned. By\ndefault, german news are returned."},"match":{"description":"Optional. Terms to be matched, multiple terms will be combined with an\n\"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTerm"}],"type":"object"},"type":"array"},"options":{"allOf":[{"$ref":"#/components/schemas/contentsearchOutputOptions"}],"description":"Optional. OutputOptions for pagination and sorting."},"searchTerm":{"description":"Optional. Search Term for fulltext-search.","type":"string"},"timeTerms":{"description":"Optional. Time terms to be matched, multiple time terms will be combined\nwith an \"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTimeTerm"}],"type":"object"},"type":"array"}},"type":"object"},"contentsearchSearchContenthubNewsTeaserResponse":{"properties":{"newsTeaser":{"description":"Optional. If news items matching the requested criteria were found, they're\nin here.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchContenthubNewsTeaser"}],"type":"object"},"type":"array"},"totalHits":{"description":"Total number of news items for this request, not taking options.page_size\ninto account.","format":"int64","type":"string"}},"type":"object"},"contentsearchSearchCorporateStoriesRequest":{"properties":{"doNotMatch":{"description":"Optional. Terms not to be matched, multiple terms will be combined with an\n\"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTerm"}],"type":"object"},"type":"array"},"language":{"allOf":[{"$ref":"#/components/schemas/contentsearchLanguage"}],"description":"Optional. If set, only stories matching this language will be returned. By\ndefault, german news are returned."},"match":{"description":"Optional. Terms to be matched, multiple terms will be combined with an\n\"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTerm"}],"type":"object"},"type":"array"},"options":{"allOf":[{"$ref":"#/components/schemas/contentsearchOutputOptions"}],"description":"Optional. OutputOptions for pagination and sorting."},"searchTerm":{"description":"Optional. Search Term for fulltext-search.","type":"string"},"timeTerms":{"description":"Optional. Time terms to be matched, multiple time terms will be combined\nwith an \"AND\" relationship.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTimeTerm"}],"type":"object"},"type":"array"}},"type":"object"},"contentsearchSearchCorporateStoriesResponse":{"properties":{"stories":{"description":"Optional. If stories matching the requested criteria were found, they're\nin here.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchCorporateStory"}],"type":"object"},"type":"array"},"totalHits":{"description":"Total number of stories for this request, not taking options.page_size into\naccount.","format":"int64","type":"string"}},"type":"object"},"contentsearchStatusResponse":{"properties":{"categoryTagDefinitions":{"description":"Cached definitions of category tags.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagDefinition"}],"type":"object"},"type":"array"},"newsTagDefinitions":{"description":"Contains the current state of cached tag definitions for news and category\ntags.\n\nCached definitions of news tags.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagDefinition"}],"type":"object"},"type":"array"}},"type":"object"},"contentsearchStory":{"description":"Story represents a story published to Migros corporate websites.","properties":{"content":{"description":"Required. The content (teaser text) of this news item.","type":"string"},"id":{"description":"Required. An opaque system ID.","type":"string"},"images":{"description":"Optional. Any images that are part of this content.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchImage"}],"type":"object"},"type":"array"},"published":{"description":"Required. True if the content has been published already, false otherwise.","type":"boolean"},"releaseTimestamp":{"description":"Optional. The time the content was published. Disregard if published =\nfalse.","format":"date-time","type":"string"},"slug":{"description":"Required. The 'slug' or internal short ID of this news item.","type":"string"},"tags":{"description":"Optional. Tags for this story, regardless of semantics (topic/category).","items":{"allOf":[{"$ref":"#/components/schemas/consolcontentsearchTag"}],"type":"object"},"type":"array"},"title":{"description":"Required. The title of this news item.","type":"string"},"topic":{"description":"Required. A topic tag \"title\" or \"name\".","type":"string"}},"type":"object"},"contentsearchTagDefinition":{"properties":{"contentfulAppId":{"description":"The app ID this tag definition belongs to.","type":"string"},"tags":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagList"}],"description":"The list of tags for this app."}},"type":"object"},"contentsearchTagList":{"properties":{"tags":{"description":"Represents multiple of tags for a specific app.","items":{"type":"string"},"type":"array"}},"type":"object"},"contentsearchTagsResponse":{"properties":{"tags":{"description":"Total number of tags for this request, not taking page_size into\n account.","items":{"allOf":[{"$ref":"#/components/schemas/contentsearchCategoryTagWithCount"}],"type":"object"},"type":"array"}},"type":"object"},"contentsearchTerm":{"properties":{"field":{"description":"Required. Name of the field this term applies to, e.g. 'tags.id'.","type":"string"},"values":{"description":"Required. Values of the above field. These will be combined with an \"OR\"\nrelationship.","items":{"type":"string"},"type":"array"}},"title":"Term matches a field with one or multiple values. Multiple values are\ncombined with an \"OR\" relationship","type":"object"},"contentsearchTimeTerm":{"description":"TimeTerm filters a time field. Either min, max or both should be provided.","properties":{"field":{"description":"Required. Name of the field that this term applies to, e.g. 'updated_at'.","type":"string"},"max":{"description":"Optional. Max timestamp value that should be allowed for the field\n(exclusive).","format":"date-time","type":"string"},"min":{"description":"Optional. Min timestamp value that should be allowed for the field\n(inclusive).","format":"date-time","type":"string"}},"type":"object"},"googlerpcStatus":{"properties":{"code":{"format":"int32","type":"integer"},"details":{"items":{"allOf":[{"$ref":"#/components/schemas/protobufAny"}],"type":"object"},"type":"array"},"message":{"type":"string"}},"type":"object"},"protobufAny":{"additionalProperties":{},"properties":{"@type":{"type":"string"}},"type":"object"}},"securitySchemes":{"apiKeyAuth":{"in":"header","name":"X-Api-Key","type":"apiKey"}}},"info":{"contact":{"email":"ARG_MGB-CONSOL-Team@mgb.ch","name":"MGB-CONSOL Team","url":"https://teams.microsoft.com/l/channel/19%3A9b261b70350d4b5797a26552deb0ea80%40thread.tacv2/CONSOL?groupId=8acfd246-03ee-4be4-98c1-b81d574b28a2&tenantId=35aa8c5b-ac0a-4b15-9788-ff6dfa22901f"},"description":"API to retrieve corporate news and stories.\n[Internal Documentation](https://git.intern.migros.net/cms/content-search) | \n[Support](https://teams.microsoft.com/l/channel/19%3A673f70e24d464b43a47bf6d1dd475091%40thread.tacv2/ContentSearch?groupId=7bbc88e7-1cac-4f22-a471-3602e44d95b7&tenantId=35aa8c5b-ac0a-4b15-9788-ff6dfa22901f)","title":"ContentSearch API QUAL","version":"v1.114.1"},"openapi":"3.0.0","paths":{"/migros/contentsearch/v1/contenthub/news/{slugOrId}":{"get":{"operationId":"ContentSearch_ContenthubNews","parameters":[{"description":"Required. Path parameter for the news item.\nRepresents either the slug or the ID of the news item. Only one value\nshould be provided.","in":"path","name":"slugOrId","required":true,"schema":{"type":"string"}},{"description":"Optional. Specifies the language in which the news article should be\nreturned. If not provided, the default language is German.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchContentHubNewsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ContenthubNews returns detailed information about a single Contenthub news\nitem identified by its slug or its ID as a path parameter.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/contenthub/newsteaser/search":{"post":{"operationId":"ContentSearch_SearchContenthubNewsTeaser","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_SearchContenthubNewsTeaserBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchSearchContenthubNewsTeaserResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchContenthubNewsTeaser returns news articles that match the given\nsearch term and optional filters.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/contenthub/newsteaser/tags":{"get":{"operationId":"ContentSearch_ListContenthubTags","parameters":[{"description":"Specifies in which language tag titles should be returned. Defaults to\nGerman.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Filter the Tags by category.","explode":true,"in":"query","name":"categoryFilter","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListContenthubTags lists available Tags for Contenthub Newsteaser.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/corporate/stories/search":{"post":{"operationId":"ContentSearch_SearchCorporateStories","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_SearchCorporateStoriesBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchSearchCorporateStoriesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchCorporateStories returns stories that match the given search term\nand optional filters","tags":["ContentSearch"]}},"/migros/contentsearch/v1/corporate/stories/tags":{"get":{"operationId":"ContentSearch_ListCorporateTags","parameters":[{"description":"Specifies in which language tag titles should be returned. Defaults to\nGerman.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Filter the Tags by category.","explode":true,"in":"query","name":"categoryFilter","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListCorporateTags lists available Tags for Corporate Stories.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/health/readyz":{"get":{"operationId":"ContentSearch_Ready","responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchReadyResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"Ready returns OK if the connection to Elasticsearch was successfully\nestablished.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/healthz":{"get":{"operationId":"ContentSearch_Health","responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchHealthResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"Health returns OK when server is running.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/migusto/article/{slugOrId}":{"get":{"operationId":"ContentSearch_MigustoArticle","parameters":[{"description":"Required. Path parameter for the article item.\nRepresents either the slug or the ID of the article item. Only one value\nshould be provided.","in":"path","name":"slugOrId","required":true,"schema":{"type":"string"}},{"description":"Optional. Specifies the language in which the article should be\nreturned. If not provided, the default language is German.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticleResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"MigustoArticle returns detailed information about a single article\nidentified by its slug or its ID.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/migusto/articles/autocomplete":{"post":{"operationId":"ContentSearch_AutocompleteMigustoArticles","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_AutocompleteMigustoArticlesBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticlesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchMigustoArticles returns articles whose titles match the given search\nterm and optional filters.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/migusto/articles/search":{"post":{"operationId":"ContentSearch_SearchMigustoArticles","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_AutocompleteMigustoArticlesBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticlesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchMigustoArticles returns articles that match the given search term and\noptional filters.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/migusto/articles/tags":{"get":{"operationId":"ContentSearch_ListMigustoTags","parameters":[{"description":"Specifies in which language tag titles should be returned. Defaults to\nGerman.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Filter the Tags by category.","explode":true,"in":"query","name":"categoryFilter","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListMigustoTags lists available Tags for Migusto Articles.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/news":{"get":{"operationId":"ContentSearch_ListNewsTeaser","parameters":[{"description":"Required. The contentful app ID to list news for, e.g. corporate.migros.ch\ntest-corporate.migros.ch.","in":"query","name":"contentfulAppId","required":true,"schema":{"type":"string"}},{"description":"Optional. If set, only news matching this language will be returned. By\ndefault, german news are returned.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Multiple news tags to include in the response. The order of the tags is irrelevant.","explode":true,"in":"query","name":"newsTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. Multiple localities for which news items should be included in the response. The order of these values is irrelevant.","explode":true,"in":"query","name":"regionTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. Multiple topic tags to exclude from the response. The order of these values is irrelevant. These values are tag IDs.","explode":true,"in":"query","name":"mustNotTopicTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional, inclusive. If specified, the 'published' timestamp of any\nnews returned will have to be the same or after this timestamp.\nThe format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.: '2025-08-21T11:54:34Z'.","in":"query","name":"publishedAtOrAfter","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Optional, exclusive. If specified, the 'published' timestamp of any\nnews returned will have to be strictly before this timestamp.\nThe format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.: '2025-08-21T11:54:34Z'.","in":"query","name":"publishedUntil","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Optional. The maximum number of news items to return in the response.","in":"query","name":"pageSize","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. An offset into the elasticsearch response from where news should\nbe returned, e.g. 6","in":"query","name":"nextPageFrom","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. Multiple sort parameters to determine the order of the results. Example: ['releaseDate:desc', '_score:desc']. Valid fields are releaseDate and _score. Each entry specifies a field and its sort direction (asc/desc).","explode":true,"in":"query","name":"sortBy","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchListNewsTeaserResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListNewsTeaser returns published news items.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/news/{slugOrId}":{"get":{"operationId":"ContentSearch_News","parameters":[{"description":"Required. Path parameter for the news item.\nRepresents either the slug or the ID of the news item. Only one value\nshould be provided.","in":"path","name":"slugOrId","required":true,"schema":{"type":"string"}},{"description":"Optional. Specifies the language in which the news article should be\nreturned. If not provided, the default language is German.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchNewsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"News returns detailed information about a single news item\nidentified by its slug or its ID as a path parameter.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/contenthub/news/{slugOrId}":{"get":{"operationId":"ContentSearch_ContenthubNewsPreview","parameters":[{"description":"Required. Path parameter for the news item.\nRepresents either the slug or the ID of the news item. Only one value\nshould be provided.","in":"path","name":"slugOrId","required":true,"schema":{"type":"string"}},{"description":"Optional. Specifies the language in which the news article should be\nreturned. If not provided, the default language is German.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchContentHubNewsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ContenthubNewsPreview returns detailed information about a single\nContenthub news item identified by its slug or its ID.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/contenthub/newsteaser/search":{"post":{"operationId":"ContentSearch_SearchContenthubNewsTeaserPreview","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_SearchContenthubNewsTeaserBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchSearchContenthubNewsTeaserResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchContenthubNewsTeaserPreview is like SearchContenthubNewsTeaser\nbut also includes articles that are only in preview mode in Contentful.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/contenthub/newsteaser/tags":{"get":{"operationId":"ContentSearch_ListContenthubTagsPreview","parameters":[{"description":"Specifies in which language tag titles should be returned. Defaults to\nGerman.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Filter the Tags by category.","explode":true,"in":"query","name":"categoryFilter","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListContenthubTagsPreview lists available Tags for Contenthub Newsteaser.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/corporate/stories/search":{"post":{"operationId":"ContentSearch_SearchCorporateStoriesPreview","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_SearchCorporateStoriesBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchSearchCorporateStoriesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchCorporateStoriesPreview is like SearchCorporateStories\nbut also includes articles that are only in preview mode in Contentful.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/corporate/stories/tags":{"get":{"operationId":"ContentSearch_ListCorporateTagsPreview","parameters":[{"description":"Specifies in which language tag titles should be returned. Defaults to\nGerman.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Filter the Tags by category.","explode":true,"in":"query","name":"categoryFilter","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListCorporateTagsPreview lists available Tags for Corporate Stories.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/migusto/article/{slugOrId}":{"get":{"operationId":"ContentSearch_MigustoArticlePreview","parameters":[{"description":"Required. Path parameter for the article item.\nRepresents either the slug or the ID of the article item. Only one value\nshould be provided.","in":"path","name":"slugOrId","required":true,"schema":{"type":"string"}},{"description":"Optional. Specifies the language in which the article should be\nreturned. If not provided, the default language is German.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticleResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"MigustoArticlePreview returns detailed information about a single article\nidentified by its slug or its ID.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/migusto/articles/autocomplete":{"post":{"operationId":"ContentSearch_AutocompleteMigustoArticlesPreview","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_AutocompleteMigustoArticlesBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticlesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"AutocompleteMigustoArticlesPreview is like AutocompleteMigustoArticles\nbut also includes articles that are only in preview mode in Contentful.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/migusto/articles/search":{"post":{"operationId":"ContentSearch_SearchMigustoArticlesPreview","requestBody":{"$ref":"#/components/requestBodies/ContentSearch_AutocompleteMigustoArticlesBody"},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchMigustoArticlesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"SearchMigustoArticlesPreview is like SearchMigustoArticles but also\nincludes articles that are only in preview mode in Contentful.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/migusto/articles/tags":{"get":{"operationId":"ContentSearch_ListMigustoTagsPreview","parameters":[{"description":"Specifies in which language tag titles should be returned. Defaults to\nGerman.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Filter the Tags by category.","explode":true,"in":"query","name":"categoryFilter","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchTagsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListMigustoTagsPreview lists available Tags for Migusto Articles.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/news":{"get":{"operationId":"ContentSearch_ListNewsTeaserPreview","parameters":[{"description":"Required. The contentful app ID to list news for, e.g. corporate.migros.ch\ntest-corporate.migros.ch.","in":"query","name":"contentfulAppId","required":true,"schema":{"type":"string"}},{"description":"Optional. If set, only news matching this language will be returned. By\ndefault, german news are returned.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"Optional. Multiple news tags to include in the response. The order of the tags is irrelevant.","explode":true,"in":"query","name":"newsTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. Multiple localities for which news items should be included in the response. The order of these values is irrelevant.","explode":true,"in":"query","name":"regionTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. Multiple topic tags to exclude from the response. The order of these values is irrelevant. These values are tag IDs.","explode":true,"in":"query","name":"mustNotTopicTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional, inclusive. If specified, the 'published' timestamp of any\nnews returned will have to be the same or after this timestamp.\nThe format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.: '2025-08-21T11:54:34Z'.","in":"query","name":"publishedAtOrAfter","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Optional, exclusive. If specified, the 'published' timestamp of any\nnews returned will have to be strictly before this timestamp.\nThe format must be 'YYYY-MM-DDTHH:mm:ssZ', e.g.: '2025-08-21T11:54:34Z'.","in":"query","name":"publishedUntil","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Optional. The maximum number of news items to return in the response.","in":"query","name":"pageSize","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. An offset into the elasticsearch response from where news should\nbe returned, e.g. 6","in":"query","name":"nextPageFrom","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. Multiple sort parameters to determine the order of the results. Example: ['releaseDate:desc', '_score:desc']. Valid fields are releaseDate and _score. Each entry specifies a field and its sort direction (asc/desc).","explode":true,"in":"query","name":"sortBy","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchListNewsTeaserResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListNewsTeaserPreview returns news items from production and those that are\nnot published yet.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/news/{slugOrId}":{"get":{"operationId":"ContentSearch_NewsPreview","parameters":[{"description":"Required. Path parameter for the news item.\nRepresents either the slug or the ID of the news item. Only one value\nshould be provided.","in":"path","name":"slugOrId","required":true,"schema":{"type":"string"}},{"description":"Optional. Specifies the language in which the news article should be\nreturned. If not provided, the default language is German.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchNewsResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"NewsPreview returns detailed information about a single news item\nidentified by its slug or its ID.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/preview/stories":{"get":{"operationId":"ContentSearch_ListStoriesPreview","parameters":[{"description":"Required. The contentful app ID to list news for, e.g. corporate.migros.ch\ntest-corporate.migros.ch.\nThis is needed in the backend so we can identify which news tags (e.g.\nWarenrückruf und Medienmitteilungen) apply; articles with those news\ntags are then excluded from the response.","in":"query","name":"contentfulAppId","required":true,"schema":{"type":"string"}},{"description":"Optional. If set, only stories matching this language will be returned. By\ndefault, german stories are returned.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"The service does not verify/validate that the passed tag IDs are indeed\ntopic tags or category tags.\n\nOptional. If empty, stories matching any topic tags are returned. If at\nleast one topic tag is given, each returned story must have at least one\nof these tags present in order to be returned.\nTag ordering within this list does not matter. Duplicates are ignored.","explode":true,"in":"query","name":"topicTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. If empty, stories of any category (e.g. \"Interview\", \"Podcast\")\nwill be returned. If at least one category tag is given, each returned\nstory must have at least one of these tags present in order to be returned.\nTag ordering within this list does not matter. Duplicates are ignored.","explode":true,"in":"query","name":"categoryTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. Specifies disallowed category tags (e.g., 'Interview', 'Podcast'). Tags matching any tag in this set will not be returned in the response. Tag ordering within this list does not matter. Duplicates are ignored.","explode":true,"in":"query","name":"mustNotTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. The maximum number of stories to return in the response.","in":"query","name":"pageSize","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. A pagination token returned from a previous call to `ListStories`\nthat indicates where this listing should continue from.","in":"query","name":"nextPageFrom","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. Multiple sort parameters to determine the order of the results. Example: ['releaseDate:desc', '_score:desc']. Valid Fields are releaseDate and _score. Each entry specifies a field and its sort direction (asc/desc). ","explode":true,"in":"query","name":"sortBy","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchListStoriesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListStoriesPreview returns stories from production and those that are not\npublished yet.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/refresh":{"post":{"operationId":"ContentSearch_Refresh","responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchRefreshResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"Refresh triggers an update of the cached \"news\" and \"category\" tag\ndefinitions. The latest tags are fetched from Contentful, and the existing\ncache is overwritten.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/statusz":{"get":{"operationId":"ContentSearch_Status","responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchStatusResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"Status provides the current state of the server, including cached \"news\"\nand \"category\" tag definitions for the supported applications.\nAt the moment, this only includes tag definitions, but this RPC\nis designed to be extended with additional runtime information in the\nfuture.","tags":["ContentSearch"]}},"/migros/contentsearch/v1/stories":{"get":{"operationId":"ContentSearch_ListStories","parameters":[{"description":"Required. The contentful app ID to list news for, e.g. corporate.migros.ch\ntest-corporate.migros.ch.\nThis is needed in the backend so we can identify which news tags (e.g.\nWarenrückruf und Medienmitteilungen) apply; articles with those news\ntags are then excluded from the response.","in":"query","name":"contentfulAppId","required":true,"schema":{"type":"string"}},{"description":"Optional. If set, only stories matching this language will be returned. By\ndefault, german stories are returned.","in":"query","name":"language","required":false,"schema":{"default":"DE","enum":["DE","FR","IT","EN"],"type":"string"}},{"description":"The service does not verify/validate that the passed tag IDs are indeed\ntopic tags or category tags.\n\nOptional. If empty, stories matching any topic tags are returned. If at\nleast one topic tag is given, each returned story must have at least one\nof these tags present in order to be returned.\nTag ordering within this list does not matter. Duplicates are ignored.","explode":true,"in":"query","name":"topicTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. If empty, stories of any category (e.g. \"Interview\", \"Podcast\")\nwill be returned. If at least one category tag is given, each returned\nstory must have at least one of these tags present in order to be returned.\nTag ordering within this list does not matter. Duplicates are ignored.","explode":true,"in":"query","name":"categoryTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. Specifies disallowed category tags (e.g., 'Interview', 'Podcast'). Tags matching any tag in this set will not be returned in the response. Tag ordering within this list does not matter. Duplicates are ignored.","explode":true,"in":"query","name":"mustNotTagIds","required":false,"schema":{"items":{"type":"string"},"type":"array"}},{"description":"Optional. The maximum number of stories to return in the response.","in":"query","name":"pageSize","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. A pagination token returned from a previous call to `ListStories`\nthat indicates where this listing should continue from.","in":"query","name":"nextPageFrom","required":false,"schema":{"format":"int64","type":"string"}},{"description":"Optional. Multiple sort parameters to determine the order of the results. Example: ['releaseDate:desc', '_score:desc']. Valid Fields are releaseDate and _score. Each entry specifies a field and its sort direction (asc/desc). ","explode":true,"in":"query","name":"sortBy","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/contentsearchListStoriesResponse"}]}}},"description":"A successful response."},"default":{"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/googlerpcStatus"}]}}},"description":"An unexpected error response."}},"security":[{"apiKeyAuth":[]}],"summary":"ListStories returns published stories.","tags":["ContentSearch"]}}},"servers":[{"url":"https://api-qual.migros.ch"}],"tags":[{"name":"ContentSearch"}],"x-company":"migros","x-headmatter":{"readable_by":"*"},"x-leanix-id":"5bbeb8fb-9bd1-4c9b-b532-645ad11c680d"}
```