{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-homepage/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img","cards","card","json-schema","json-example"]},"type":"markdown"},"seo":{"title":"Discover Feed"},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"discover-feed","__idx":0},"children":["Discover Feed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example shows how to generate the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Discover"]}," feed. The Discover feed takes you to a collection of posts within topics. These topics are marked as followed, recommended, popular and latest."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The example below shows a user accessing their Discover feed from their header bar menu."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/discoverfeedmenu.dee3dab3d49424af0b95529ba36412ed25541b48792160877ba23440b5c34ec0.9c1bb791.png","alt":"discoverfeedmenu.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example UI"]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/discoverfeed.5785148a05e3195730ebe3f0dece42496178332cf1a9d1919ae47a938d314e3b.9c1bb791.png","alt":"Discoverfeed.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":1,"cardMinWidth":180},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"GET /v2/feed/channels/posts","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/endpoints/openapi/feed-channel-posts/listfeedchannelposts"},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Query"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These feeds are returned by the same endpoint, but with a different query name:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Feed Name"},"children":["Feed Name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Followed Topics"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"following\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommended"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"recommended\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Popular"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"popular\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Latest"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"latest\""]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-schema","__idx":1},"children":["Request schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"type":"object","properties":{"name":{"type":"string","enum":["following","recommended","latest","popular","most_contributed","visible","search"],"default":"following","description":"Use a specific named feed, which is a preset of filters for specific types of feeds."},"query":{"type":"string","description":"Find content matching provided keywords. Required when using search."},"page.size":{"type":"integer","description":"Number of records to return per page. Default is 10 and maximum is 100."},"page.number":{"type":"integer","description":"Using classical pagination, the page number to return. Default is 1."}}},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"type":"object","properties":{"name":{"type":"string","enum":["following","recommended","latest","popular","most_contributed","visible","search"],"default":"following","description":"Use a specific named feed, which is a preset of filters for specific types of feeds."},"query":{"type":"string","description":"Find content matching provided keywords. Required when using search."},"page.size":{"type":"integer","description":"Number of records to return per page. Default is 10 and maximum is 100."},"page.number":{"type":"integer","description":"Using classical pagination, the page number to return. Default is 1."}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-used-in-this-example","__idx":2},"children":["Response used in this example"]},{"$$mdtype":"Tag","name":"JsonExample","attributes":{"json":{"data":[{"id":9201,"title":"Welcome to the new employee experience","summary":"An overview of the latest updates and how to get started.","content_type":"article","author":{"user_id":301,"display_name":"Stephanie Hanakova","avatar_url":"https://cdn.example.com/users/stephanie/avatar.png"},"channels":[{"channel_id":51,"name":"All things wellness!"}],"visibility":"public","featured":false,"comment_count":0,"engagement":{"total_likes_count":0,"total_shares_count":0,"total_bookmarks_count":0},"poster_image_url":"https://cdn.example.com/posts/welcome-experience.png","permalink_url":"https://onfirstup.com/acme/acmetimes/sc4#contents/9201","shareable_url":"https://onfirstup.com/acme/acmetimes/sc4#contents/9201","published_at":"2026-03-24T09:00:00Z"},{"id":9202,"title":"Learning pathways for new managers","summary":"Recommended learning content from topics the user already follows.","content_type":"link","author":{"user_id":302,"display_name":"Courtney Eck","avatar_url":"https://cdn.example.com/users/courtney/avatar.png"},"channels":[{"channel_id":52,"name":"Courtney's Corner"}],"visibility":"public","featured":false,"comment_count":0,"engagement":{"total_likes_count":0,"total_shares_count":0,"total_bookmarks_count":0},"permalink_url":"https://onfirstup.com/acme/acmetimes/sc4#contents/9202","shareable_url":"https://onfirstup.com/acme/acmetimes/sc4#contents/9202","published_at":"2026-03-23T09:00:00Z"},{"id":9203,"title":"This week in People and Culture","summary":"Recent updates from one of the user’s followed topics.","content_type":"note","author":{"user_id":301,"display_name":"Stephanie Hanakova","avatar_url":"https://cdn.example.com/users/stephanie/avatar.png"},"channels":[{"channel_id":53,"name":"People and Culture"}],"visibility":"public","featured":false,"comment_count":0,"engagement":{"total_likes_count":0,"total_shares_count":0,"total_bookmarks_count":0},"permalink_url":"https://onfirstup.com/acme/acmetimes/sc4#contents/9203","shareable_url":"https://onfirstup.com/acme/acmetimes/sc4#contents/9203","published_at":"2026-03-22T09:00:00Z"}],"meta":{"feed_name":"following","pagination":{"page":1,"size":10}}},"errors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-schema","__idx":3},"children":["Response schema"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../endpoints/openapi.yaml#/paths/~1v2~1feed~1channels~1posts/get/responses/200/content/application~1json/schema"},"options":{},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/schema"},"Content.Post.Resource.author":{"type":"object","properties":{"avatar_url":{"description":"Path to an image representing the author.","type":"string","example":"https://example.com/avatar.png"},"display_name":{"description":"The name to display as the author.","type":"string","example":"Some User"},"user_id":{"description":"The Firstup user_id of the author.","type":"integer","example":123}}},"Content.Image.Resource":{"type":"object","properties":{"id":{"type":"integer","description":"The unique identifier of this image record","example":678},"image_url":{"type":"string","example":"https://cdn.example.com/acme/acmetimes/images/abc123"},"width":{"type":"integer","description":"The width of the image in pixels","example":1024},"height":{"type":"integer","description":"The height of the image in pixels","example":768}}},"Feeds.Post.Resource":{"type":"object","properties":{"id":{"type":"integer","description":"Unique identifier for this post","example":456},"uuid":{"type":"string","format":"uuid","example":"8b358e6b-11d4-4e89-bf7f-ec670e3398ed"},"version":{"type":"integer","description":"The version of the content creation studio used to generate the content.\n- `1` - Legacy Studio\n- `2` - Creator Studio\n","enum":[1,2]},"content_type":{"type":"string","description":"The type of content. One of: article, image, link, note, or video. The content_type can determine how the post should be presented. ","example":"article"},"title":{"type":"string","description":"The post title. Can also be considered the headline.","example":"Example Post Title"},"summary":{"type":"string","description":"Short summary of the post.","example":"Example Post Summary"},"body":{"type":"string","description":"The body of the post.","example":"Example post body"},"accent_color":{"type":"string","description":"The color of the post, currently only applicable to notes."},"author":{"$ref":"#/components/schemas/Content.Post.Resource.author"},"channels":{"type":"array","description":"A list of the topics this post is published to.","items":{"type":"object","properties":{"channel_id":{"type":"integer","example":789,"description":"Topic's unique identifier (GUID). <br/><br/> <b>NOTE:</b> Originally called \"id\" in this documentation.\n"},"name":{"type":"string","example":"Name of Example Topic","description":"Topic's name. <br/><br/> <b>NOTE:</b> Originally called \"title\" in this documentation.\n"}}}},"engagement":{"type":"object","properties":{"liked_at":{"type":"string","format":"date-time","description":"Date and time at which the user liked the post. If the user has not liked the post, this value will be null.","example":"2000-01-01T00:00:00Z"},"bookmarked_at":{"type":"string","format":"date-time","description":"Date and time at which the user bookmarked the post. If the user has not bookmarked the post, this value will be null.","example":"2000-01-01T00:00:00Z"},"viewed_at":{"type":"string","format":"date-time","description":"Date and time at which the user viewed the post. If the user has not viewed the post, this value will be null.","example":"2000-01-01T00:00:00Z"},"total_likes_count":{"type":"integer","format":"int64","description":"The total likes of this post within the program by any user.","example":5},"total_shares_count":{"type":"integer","format":"int64","description":"The total number of shares of this post within the program by any user.","example":5},"total_bookmarks_count":{"type":"integer","format":"int64","description":"The total number of bookmarks this post has got within the program by any user.","example":5}}},"updated_at":{"type":"string","format":"date-time","description":"When this content was last updated in ISO8601 format and UTC timezone.","example":"2000-01-01T00:00:00Z"},"published_at":{"type":"string","format":"date-time","description":"When this content was published in ISO8601 format and UTC timezone.","example":"2000-01-01T00:00:00Z"},"visibility":{"type":"string","enum":["private","public","any"],"description":"An indication of the native availability of the post within the Firstup platform. If 'public', the post has a public_link_url and shares of the post should use that url as the canonical url. If 'private', the post requires user authentication to view.\n","example":"public"},"featured":{"type":"boolean","description":"Whether the post is featured.","example":true},"featured_label":{"type":"string","description":"The content's feature label","example":"Save Pandora!"},"permalink_url":{"type":"string","description":"The url of the post on the Firstup platform.","example":"https://onfirstup.com/acme/acmetimes/sc4#contents/456"},"shareable_url":{"type":"string","description":"The publicly shareable url of the post if it's visibility is public. Private visibility posts will have no shareable_url.\n","example":"https://onfirstup.com/acme/acmetimes/sc4#contents/456"},"prepopulated_share_message":{"type":"string","description":"The auto-generated string used when sharing the post.\n","example":"Example Post Title https://onfirstup.com/acme/acmetimes/sc4#contents/456"},"appended_hashtag":{"type":"string","description":"The hashtag configured to be included when sharing the posts. example: #YourBrand\n"},"language":{"type":"string","description":"The language. For non-translatable posts, this value will be null.","example":"en"},"is_translatable":{"type":"boolean","description":"Whether the content is translatable.","example":true},"is_commentable":{"type":"boolean","description":"Whether the content allows comments.","example":true},"comment_count":{"type":"integer","description":"The number of comments on the content.","example":5},"poster_image_url":{"type":"string","description":"The url of the primary image used for this post, if one exists. ","example":"https://cdn.example.com/acme/acmetimes/images/abc123"},"links":{"type":"array","items":{"type":"object","properties":{"link_url":{"type":"string","example":"https://google.com"}}}},"images":{"type":"array","items":{"$ref":"#/components/schemas/Content.Image.Resource"}},"videos":{"type":"array","items":{"type":"object","properties":{"embed_html":{"type":"string","description":"Html that can be used to embed the video in a page, wrapped in an iframe widget.\n","example":"<iframe href='https://onfirstup.com/acme/acmetimes/sc4#contents/456/videos/abc123'></iframe>\n"},"link_url":{"type":"string","description":"A link to the video where it can be played","example":"https://onfirstup.com/acme/acmetimes/sc4#contents/456/videos/abc123"}}}}}},"Standard.Feed.Meta.PagePagination":{"type":"object","properties":{"page":{"description":"The page returned. Defaults to `1`.","example":1},"page_size":{"description":"The max number of records requested with pagination applied. Is not necessarily an exact count of the current records returned. Defaults to `10`.\n","example":10}}},"schema":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Feeds.Post.Resource"}},"meta":{"properties":{"filters":{"description":"A list of the filters applied in the current request.","example":{"content_type":"article","visibility":"public"}},"feed_name":{"description":"The current feed name; `following`, or `search` when a query is supplied.","example":"following"},"pagination":{"$ref":"#/components/schemas/Standard.Feed.Meta.PagePagination"}}}}}}}},"schemaResolvedErrors":[]},"children":[]}]},"headings":[{"value":"Discover Feed","id":"discover-feed","depth":1},{"value":"Request schema","id":"request-schema","depth":2},{"value":"Response used in this example","id":"response-used-in-this-example","depth":2},{"value":"Response schema","id":"response-schema","depth":2}],"frontmatter":{"seo":{"title":"Discover Feed"}},"lastModified":"2026-04-01T12:56:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/toplevelbanner/feedsdiscover","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}