Skip to content
/
Changelog
Last updated

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 PathNova 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
Previous page
Next page