--- title: "community.feed-item@1 · OpenVibe.Services" canonical: "https://openvibe.services/docs/contracts/community.feed-item" updated: null --- # community.feed-item@1 · OpenVibe.Services HTML: [community.feed-item@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/community.feed-item) # CommunityFeedItem `community.feed-item@1` Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0). - Version: 1.0.0 - Owner: community - Visibility: public - Status: active - Compatibility: backward - Schema: [`https://openvibe.network/contracts/community/feed-item.v1.json`](/docs/contracts/community.feed-item.json) community.feed-item@1: one card of the menu's Feed on every OpenVibe site (GET /api/v1/feed, OpenVibe.Community server/pulse/feed.js). Each card keeps its source and public visibility. Scheduled calendar cards appear only before their start time; bursts can carry a group of links. Counts carry Community's own views, likes and comments where it knows them. ## Fields | Field | Type | Required | Description | Constraints | | --- | --- | --- | --- | --- | | `id` | string | yes | Stable within one response: p: for a Pulse item, t:: for a trending card. | - `minLength 1`
- `maxLength 500` | | `kind` | enum | yes | | - `one of "live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member", "avatar", "banner", "paste", "site", "space", "follow", "episode"` | | `url` | string | yes | Where the card opens; https unless the source itself answered an http URL. | - `pattern ^https?://`
- `maxLength 2000` | | `title` | string | yes | | - `maxLength 300` | | `text` | string | yes | The source's first 280 characters, on one line; empty when it has none. | - `maxLength 280` | | `at` | string \| null | yes | When it happened (Pulse provenance); null for a trending card. | - `format date-time` | | `starts_at` | string | | The start time of a Coming up calendar item; absent on other kinds. | - `format date-time` | | `visibility` | enum | | Present only for an item returned to a follower or its author. | - `one of "followers"` | | `site` | string | yes | The source service (live, media-hub, pics, games, blog, wiki, quest, chat, today, network, community…). | - `maxLength 40` | | `site_name` | string | yes | | - `maxLength 40` | | `actor` | object \| null | yes | Who did it; null for AI, system, aggregate and trending cards. | | | `media` | object \| null | yes | The card's first picture, as a Media thumbnail; null when it has none. | | | `counts` | object | yes | Community's own numbers, each present only when it knows it; {} for another service's item. | - `no other fields` | | `counts.views` | integer | | | - `minimum 0` | | `counts.likes` | integer | | | - `minimum 0` | | `counts.comments` | integer | | | - `minimum 0` | | `live_now` | boolean | | Present on live and stream cards: true only while the channel is currently on air. A past broadcast has kind stream and live\_now false. | | | `group` | object | | | - `no other fields` | | `group.count` | integer | yes | | - `minimum 2` | | `group.items` | array of object | yes | | - `minItems 2`
- `items: no other fields` | | `group.items[].id` | string | yes | | | | `group.items[].url` | string | yes | | - `pattern ^https://` | | `group.items[].title` | string | yes | | | | `group.items[].media` | object \| null | yes | | | | `label` | enum | | Present only when the card needs one. | - `one of "Trending", "AI", "System"` | ## Examples From the contract's own test fixtures: valid ones validate, rejected ones must fail. Valid: live ~~~~ { "id": "p:42", "kind": "live", "url": "https://openvibe.live/@alex", "title": "Alex went live", "text": "", "at": "2026-11-09T10:15:00.000Z", "site": "live", "site_name": "Live", "actor": { "name": "Alex", "avatar": "https://openvibe.network/avatar/alex?s=96" }, "media": null, "counts": {}, "live_now": true } ~~~~ Valid: post-with-picture ~~~~ { "id": "p:9171", "kind": "post", "url": "https://openvibe.community/forum/status/look-at-this-cat", "title": "Look at this cat", "text": "Look at this cat", "at": "2026-11-09T10:15:00.000Z", "site": "community", "site_name": "Community", "actor": { "name": "Alex", "avatar": "https://openvibe.network/avatar/alex?s=96" }, "media": { "thumb": "https://openvibe.media/o/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "ratio": 1.7777777777777777 }, "counts": { "views": 7, "likes": 3, "comments": 2 } } ~~~~ Valid: stream ~~~~ { "id": "p:42", "kind": "stream", "url": "https://openvibe.live/@alex", "title": "Alex went live", "text": "", "at": "2026-11-09T10:15:00.000Z", "site": "live", "site_name": "Live", "actor": { "name": "Alex", "avatar": "https://openvibe.network/avatar/alex?s=96" }, "media": null, "counts": {}, "live_now": false } ~~~~ Rejected: kind-not-in-the-feed ~~~~ { "id": "p:1", "kind": "food", "url": "https://openvibe.community/p/one", "title": "Not a kind the feed shows", "text": "", "at": null, "site": "community", "site_name": "Community", "actor": null, "media": null, "counts": {} } ~~~~ Rejected: live-now-string ~~~~ { "id": "p:9171", "kind": "post", "url": "https://openvibe.community/forum/status/look-at-this-cat", "title": "Look at this cat", "text": "Look at this cat", "at": "2026-11-09T10:15:00.000Z", "site": "community", "site_name": "Community", "actor": { "name": "Alex", "avatar": "https://openvibe.network/avatar/alex?s=96" }, "media": { "thumb": "https://openvibe.media/o/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "ratio": 1.7777777777777777 }, "counts": { "views": 7, "likes": 3, "comments": 2 }, "live_now": "false" } ~~~~ Rejected: negative-count ~~~~ { "id": "p:9171", "kind": "post", "url": "https://openvibe.community/forum/status/look-at-this-cat", "title": "Look at this cat", "text": "Look at this cat", "at": "2026-11-09T10:15:00.000Z", "site": "community", "site_name": "Community", "actor": { "name": "Alex", "avatar": "https://openvibe.network/avatar/alex?s=96" }, "media": { "thumb": "https://openvibe.media/o/med_01JAB2C3D4E5F6G7H8J9K0MNPQ", "ratio": 1.7777777777777777 }, "counts": { "likes": -1 } } ~~~~ ## Validate ~~~~ const contracts = require('openvibe-contracts'); contracts.validate('community.feed-item@1', value); // { valid, errors: [{ path, message }] } ~~~~