Manage knowledge-sharing sessions within groups. Create, list, and update sessions.
Sessions
Sessions are time-bound knowledge-sharing events within a group. Team members contribute links, articles, and resources during sessions.
List Sessions
Retrieve all sessions for a group.
GET /api/v1/groups/:groupId/sessions
Query Parameters
| Parameter | Type | Description |
|---|---|---|
status | string | Filter by draft, active, or archived |
limit | number | Results per page (default 20, max 100) |
offset | number | Pagination offset |
Response
json
{
"data": [
{
"id": "uuid",
"title": "Week 10 - Tech Radar",
"description": "Monthly technology radar review",
"status": "active",
"item_count": 8,
"created_by": "uuid",
"created_at": "2026-03-04T09:00:00Z"
}
]
}
Create Session
Create a new session in a group.
POST /api/v1/groups/:groupId/sessions
Body
json
{
"title": "Week 11 - Innovation Review",
"description": "Share interesting tools and frameworks discovered this week"
}
| Field | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Session title (max 200 chars) |
description | string | No | Session description |
Update Session
Update a session's details or status.
PATCH /api/v1/groups/:groupId/sessions/:id
Body
json
{
"status": "archived"
}
| Field | Type | Required | Description |
|---|---|---|---|
title | string | No | Updated title |
description | string | No | Updated description |
status | string | No | draft, active, or archived |