Changelog
Stay up to date with new APIs, webhooks, and improvements across the Workvivo Developer Platform.
Manage article archival
POST /v1/articles and PUT /v1/articles/{id} now accept archive_at to schedule, reschedule, or remove an archival date. GET /v1/articles also accepts a state of published, archived, or all. Article responses and webhooks now include archive_at and is_archived.
Return clear error for concurrent DELETE requests
Concurrent deletion requests for the same badge, event, kudos, page, or update now return 409 Conflict, preventing duplicate deletion webhooks and making retries safer.
View content approval status for updates and kudos
Update and kudos responses now include a content_approval object when space content approvals are enabled for your organisation.
Filter audience-based collections with all
The GET /v1/updates, GET /v1/kudos, and GET /v1/events endpoints now accept the all keyword for the space_ids and team_ids parameters to return content across every space or team the API key has access to.
View list of users assigned a particular badge
Added the GET /v1/badges/{id}/users endpoint to list users assigned to a badge.
Badge webhooks
Added badge.assigned and badge.unassigned webhook events for badge lifecycle changes.
Archive articles instead of deleting them
DELETE /v1/articles/{id} now archives articles instead of permanently removing assets, preserving images and attachments referenced elsewhere.
Subscribe to document events
Added document webhook events for document.created, document.updated, and document.deleted.
List and retrieve webhook subscriptions
Added the GET /v1/webhooks and GET /v1/webhooks/{id} endpoints to return all your configured and specific webhook subscriptions.
Faster updates listing
Improved performance on the GET /v1/updates endpoint.
Subscribe to page events
Added page webhook events for page.created, page.updated, and page.deleted.
Filter pages by builder version
GET /v1/pages now accepts an optional page_edition parameter to filter the builder version.
Retrieve campaigns for updates and kudos
Added GET /v1/updates/{id}/campaigns and GET /v1/kudos/{id}/campaigns to return campaigns for updates and kudos, and a new campaign field is included in the retrieval of both resources.
Return unsigned image URLs on pages and articles
Added the sign_url parameter to GET /v1/pages and GET /v1/articles to return internal image references instead of expiring signed URLs in the html_content field in the response.
Assign new space roles
PATCH /v1/spaces/{id}/users now accepts new role types of editor, pages_editor, news_editor, events_editor, documents_editor, and member.
Filter advanced search by creator ID or email
GET /v1/jwt/advanced-search now accepts the optional parameters creator_id or creator_email to filter results to content created by a single user.
Acknowledge updates and users
Added the GET /v1/updates/{id}/acknowledgement endpoint to return acknowledgement details and the GET /v1/updates/{id}/acknowledgement/users endpoint listing the users who acknowledged. Also added for the kudos related endpoints.
Faster and new sort order for the activity feed
GET /v1/jwt/activity now returns activities by most recent activity by default for performance improvements on large responses.
List and retrieve chat channels
Added the GET /v1/chat/channels endpoint to list chat channels and the GET /v1/chat/channels/{channel_url} endpoint to retrieve a single chat channel by its URL.
Set a custom attachment expiry
Admins can set a custom expiry for attachment URLs delivered via the Customer API and webhooks under Admin > Tools > Platform > Sign URL Settings.
Filter advanced search by date range across more types
GET /v1/jwt/advanced-search now honours the parameters startDate and endDate for goals, pages, people, spaces, and teams, alongside the existing types.
Add members to a chat channel
Added the PATCH /v1/chat/channels/{channel_url}/members endpoint to add users or global chatbots to a chat channel.
Change a member's role in a space
PATCH /v1/spaces/{id}/users and PATCH /v1/spaces/by-external-id/{id}/users now accept six new parameters per endpoint to update a space member's role.
Archive and unarchive a space
Added 2 new endpoints POST /v1/spaces/{id}/archive and POST /v1/spaces/{id}/unarchive to archive or unarchive a space and its related content (articles, events, featured promotion).
List users who acknowledged an article
Added the GET /v1/articles/{id}/acknowledgement/users endpoint to return a list of users who acknowledged the article.
Filter articles by acknowledgement
GET /v1/articles accepts a has_acknowledgement parameter to return only articles that have been acknowledged.
Update a space
Added the PUT /v1/spaces/{id} endpoint to update a space's attributes.
Set the language on updates and kudos
Added a language parameter to the creating and updating updates and kudos endpoints to specify language.
Filter billboards and livestreams by date range
Added the startDate and endDate parameters to the GET /v1/billboards and GET /v1/livestreams endpoints to filter by date range.