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}, /v2/webhooks/{id}/secret

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 with signing secret rotation (/v2/webhooks/{id}/secret)

Conversation Webhook Topics

16 new webhook topics for real-time conversation events:

  • User actions: conversation.user.created, conversation.user.replied
  • Admin actions: conversation.admin.replied, conversation.admin.noted, conversation.admin.closed, conversation.admin.opened, conversation.admin.snoozed, conversation.admin.unsnoozed, conversation.admin.assigned
  • Conversation state: conversation.priority.updated, conversation.handover_requested, conversation.deleted, conversation.read
  • Participants: conversation.contact.attached, conversation.contact.detached
  • Content: conversation_part.redacted

Enhanced Pagination

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

Integrations Support in Posts

  • Response: Post objects now include an integrations field containing linked third-party integration data (Linear, Jira, ClickUp, GitHub, Azure DevOps, HubSpot)
  • Create Post: New optional integrations parameter when creating a post to push it to configured third-party integrations (Linear, ClickUp, GitHub, Jira, Discord, Slack). Set each integration to true to trigger the push
  • Create Post (POST /v2/posts): New optional notifyAdmins boolean (default false). When true, admins receive email notifications for the new post—the same emails as when a post is created from the dashboard

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