---
title: "community.feed-card@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/community.feed-card"
updated: null
---

# community.feed-card@1 · OpenVibe.Services

HTML: [community.feed-card@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/community.feed-card)

# CommunityFeedCard `community.feed-card@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-card.v1.json`](/docs/contracts/community.feed-card.json)

community.feed-card@1: one public card returned by GET /api/v1/feed on OpenVibe.Community.

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `id` | string | yes |  | - `minLength 1`<br>- `maxLength 500` |
| `kind` | enum | yes |  | - `one of "live", "stream", "clip", "video", "pic", "post", "meme", "game", "update", "wiki", "quest", "chat", "event", "member"` |
| `url` | string | yes |  | - `pattern ^https?://`<br>- `maxLength 2000` |
| `title` | string | yes |  | - `maxLength 300` |
| `text` | string | yes |  | - `maxLength 280` |
| `at` | string \| null | yes |  | - `format date-time` |
| `site` | string | yes |  | - `maxLength 40` |
| `site_name` | string | yes |  | - `maxLength 40` |
| `actor` | object \| null | yes |  |  |
| `media` | object \| null | yes |  |  |
| `counts` | object | yes |  | - `no other fields` |
| `counts.views` | integer |  |  | - `minimum 0` |
| `counts.likes` | integer |  |  | - `minimum 0` |
| `counts.comments` | integer |  |  | - `minimum 0` |
| `live_now` | boolean |  |  |  |
| `label` | enum |  |  | - `one of "Trending", "AI", "System"` |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

 Valid: basic

~~~~
{
  "id": "p:42",
  "kind": "clip",
  "url": "https://openvibe.live/clip/42",
  "title": "A highlight",
  "text": "A short clip",
  "at": "2026-11-10T12:00:00.000Z",
  "site": "live",
  "site_name": "Live",
  "actor": {
    "name": "Ada",
    "avatar": null
  },
  "media": {
    "thumb": "https://openvibe.media/42.webp",
    "preview": "https://openvibe.media/42.mp4",
    "ratio": 1.7778,
    "length": 18
  },
  "counts": {
    "views": 12,
    "likes": 3,
    "comments": 1
  },
  "live_now": false
}
~~~~

Rejected: missing-title

~~~~
{
  "id": "p:42",
  "kind": "clip",
  "url": "https://openvibe.live/clip/42",
  "text": "A short clip",
  "at": null,
  "site": "live",
  "site_name": "Live",
  "actor": null,
  "media": null,
  "counts": {}
}
~~~~

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('community.feed-card@1', value);   // { valid, errors: [{ path, message }] }
~~~~