## Changelog: Nova (2026-01-01) vs Clover (2025-12-12)

### Breaking Changes

#### Removed Endpoints

The following endpoints are **not available** in Clover and were added in Nova:

- **Post Statuses**: `/v2/post_statuses`, `/v2/post_statuses/{id}`
- **Contacts**: `/v2/contacts`, `/v2/contacts/{id}`, `/v2/contacts/by-user-id/{userId}`, `/v2/contacts/{id}/block`, `/v2/contacts/{id}/unblock`
- **Teams**: `/v2/teams`, `/v2/teams/{id}`
- **Companies**: `/v2/companies`, `/v2/companies/{id}`, `/v2/companies/{id}/contacts`, `/v2/companies/{id}/contacts/{contactId}`
- **Conversations**: `/v2/conversations`, `/v2/conversations/{id}`, `/v2/conversations/{id}/reply`, `/v2/conversations/{id}/participants`, `/v2/conversations/redact`
- **Webhooks**: `/v2/webhooks`, `/v2/webhooks/{id}`


#### Path Changes

| Clover Path | Nova Path |
|  --- | --- |
| `/v2/posts` (all methods) | `/v2/posts` + `/v2/posts/{id}` (separate endpoints) |
| `/v2/posts/upvoters` | `/v2/posts/{id}/voters` |
| `/v2/comment` (all methods) | `/v2/comments` + `/v2/comments/{id}` |
| `/v2/changelog` (all methods) | `/v2/changelogs` + `/v2/changelogs/{id}` |
| `/v2/changelog/publish` | `/v2/changelogs/{id}/publish` |
| `/v2/changelog/unpublish` | `/v2/changelogs/{id}/unpublish` |
| `/v2/changelog/subscribers` | `/v2/changelogs/subscribers` |


#### Pagination Changes

- **Clover**: Page-based pagination with `page` and `limit` parameters
- **Nova**: Cursor-based pagination with `cursor` and `limit` parameters


#### Response Format Changes

- **Clover**: `{ success: true, results: [...], page, limit, totalResults }`
- **Nova**: `{ object: "list", data: [...], nextCursor }`


#### Schema Changes

- Nova adds `object` field to all resource types (e.g., `"object": "post"`, `"object": "comment"`)
- Some ID fields renamed: Clover uses `_id` in some places, Nova uses `id`
- Nova includes additional metadata fields in responses


#### Authentication

- **Clover**: `X-API-Key` header
- **Nova**: `Authorization: Bearer <api-key>` header


### New Features in Nova

#### New Endpoints

- Post Statuses management
- Contacts management with blocking/unblocking
- Teams management
- Companies management with contact associations
- Conversations (inbox) with replies and participants
- Webhooks management


#### Enhanced Pagination

- Cursor-based pagination for more reliable iteration through large datasets
- `nextCursor` field for fetching subsequent pages


#### Richer Response Schemas

- `object` field identifies resource type in all responses
- More detailed error codes and messages
- Additional metadata on resources


### Migration Guide: Clover → Nova

1. **Update authentication**: Change `X-API-Key: {key}` to `Authorization: Bearer {key}`
2. **Update pagination**: Replace `page` parameter with `cursor`, use `nextCursor` from responses
3. **Update response parsing**: Access data via `data` array instead of `results`, check `object` field for type
4. **Update paths**: Use new path patterns with `{id}` in URL instead of request body
5. **Set version header**: Include `Featurebase-Version: 2026-01-01.nova` in all requests