Changelog

Here you can find all the information you need to keep up with the latest updates to Foru.ms, including new features, bug fixes, and improvements.

Version 2.0

Release Date: January 8, 2026

Version 2.0 introduces a redesigned API with improved consistency, better resource naming, and standardized response formats. This is a major release with breaking changes.

Breaking Changes

Resource Path Changes

All singular resource paths have been consolidated to their plural form:

v1 Path	v2 Path
`/api/v1/thread/*`	`/api/v2/threads/*`
`/api/v1/post/*`	`/api/v2/posts/*`
`/api/v1/user/*`	`/api/v2/users/*`
`/api/v1/tag/*`	`/api/v2/tags/*`
`/api/v1/notification/*`	`/api/v2/notifications/*`
`/api/v1/private-message/*`	`/api/v2/private-messages/*`
`/api/v1/report/*`	`/api/v2/reports/*`
`/api/v1/role/*`	`/api/v2/roles/*`

Pagination Response Format

All list endpoints now use a standardized pagination envelope:


{
  "data": {
    "items": [...],
    "nextCursor": "...",
    "count": 123
  }
}

Previously, responses used resource-specific keys like threads, posts, users. Now, all list endpoints return items under the items key.

Reactions System

The like, dislike, upvote, and downvote endpoints have been consolidated into a unified reactions subresource:

v1: POST /api/v1/thread/:id/like, POST /api/v1/post/:id/upvote
v2: POST /api/v2/threads/:id/reactions, POST /api/v2/posts/:id/reactions

Reaction type is now specified in the request body.

Query Parameter Changes

Relationship endpoints have been flattened into query filters:

v1 Endpoint	v2 Equivalent
`GET /api/v1/tag/:id/threads`	`GET /api/v2/threads?tagId=:id`
`GET /api/v1/user/:id/threads`	`GET /api/v2/threads?userId=:id`
`GET /api/v1/user/:id/posts`	`GET /api/v2/posts?userId=:id`

Error Response Format

All errors now follow a consistent format:


{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable message",
    "details": {}
  }
}

Subresource Patterns

New subresource patterns for related data:

GET /api/v2/threads/:id/posts - Get posts in a thread
GET /api/v2/threads/:id/subscribers - Get thread subscribers
POST /api/v2/private-messages/:id/replies - Reply to a private message (was POST /api/v1/private-message/:id)
GET /api/v2/webhooks/:id/deliveries - Get webhook delivery history

New Features

Unified Reactions API: Single endpoint for all reaction types with flexible reaction definitions
Poll Voting Subresource: Polls now accessible via GET/POST /api/v2/threads/:id/poll with dedicated voting at /api/v2/threads/:id/poll/votes
Improved Search: Enhanced search with type parameter supporting threads, posts, users, and tags
Centralized Auth Middleware: Single middleware for JWT and API key authentication
OpenAPI Specification: Full OpenAPI 3.0 spec generated from Zod schemas
Rate Limiting: Improved rate limiting with subscription-tier awareness

Improvements

Response Schema Validation: All responses validated against Zod schemas
Consistent Cursor Pagination: Standardized cursor and limit parameters across all endpoints
Better Type Safety: Full TypeScript types for all request/response objects
Structured Logging: Request/response logging for debugging
CORS Preflight Handling: Proper OPTIONS request handling

Version 1.3.3 - 1.9

New Features: Added postsCount?: number and threadsCount?: number to User interface
Added postsCount?: number and lastPostAt?: string to Thread interface
Added tags?: string[] to UpdateThreadPayload

Version 1.1.0

New Features: Ability to create teams, invite members, and manage team permissions.
Bug Fixes: Issues with the team invitation process and the team management interface.
Improvements: Updates to the team management interface and the team invitation process.

Version 1.0.0

New Features: Ability to create roles, notifications, and reports.
Bug Fixes: Issues with the API Console and the Dashboard.
Improvements: Dashboard and the API Console.