Merge branch 'update-specs' of https://github.com/devrev/fern-api-docs into update-specs

Author: bc-devrev

fern/apis/beta/changelog/2025-01-17.md

@@ -1,40 +1,100 @@
 
-# API Changelog
+## Conversations
+
+### Modified Response Schema
+The following endpoints have updated conversation response schemas to include meeting support in timeline entries and SLA tracking improvements:
+
+- [`/conversations.create`](/beta/api-reference/conversations/create)
+- [`/conversations.export`](/beta/api-reference/conversations/export-post) 
+- [`/conversations.get`](/beta/api-reference/conversations/get-post)
+- [`/conversations.list`](/beta/api-reference/conversations/list-post)
+- [`/conversations.update`](/beta/api-reference/conversations/update)
+
+Changes:
+- Added meeting support in timeline events through new `meeting` type in source/target links
+- Added `applies_to_type` property to SLA tracker
+- Added `completed_at` property to metric target summaries in SLA tracking
 
 ## Links
-- Added support for meetings in link objects - `type` enum now includes `meeting` value
-- This affects the following endpoints:
-  - [`/links.create`](/beta/api-reference/links/create)
-  - [`/links.get`](/beta/api-reference/links/get-post)
-  - [`/links.list`](/beta/api-reference/links/list-post)
-
-## SLA
-### SLA Trackers
-- Added new property `applies_to_type` to SLA tracker objects 
-- Added new property `completed_at` to metric target summaries
-- This affects the following endpoints:
-  - [`/sla-trackers.get`](/beta/api-reference/slas/sla-trackers-get-post)
-  - [`/sla-trackers.list`](/beta/api-reference/slas/sla-trackers-list-post)
-
-### SLAs
-- Added new property `account_filter` to SLA objects
-- This affects the following endpoints:
-  - [`/slas.create`](/beta/api-reference/slas/create)
-  - [`/slas.get`](/beta/api-reference/slas/get-post)
-  - [`/slas.list`](/beta/api-reference/slas/list-post)
-  - [`/slas.transition`](/beta/api-reference/slas/transition)
-  - [`/slas.update`](/beta/api-reference/slas/update)
-
-## Works
-- Added new query parameter `state` for filtering works
-- This affects the following endpoints:
-  - [`/works.export`](/beta/api-reference/works/export-post)
-  - [`/works.list`](/beta/api-reference/works/list-post)
-
-The changes are primarily focused on:
-1. Adding support for meetings in link objects
-2. Enhancing SLA tracking capabilities with new properties
-3. Adding account filtering to SLAs  
-4. Adding state filtering capability for works endpoints
-
-All modified endpoints continue to maintain backward compatibility while adding these new capabilities.
+
+### Modified Response Schema
+The following endpoints have updated link schemas to support meetings:
+
+- [`/links.create`](/beta/api-reference/links/create)
+- [`/links.get`](/beta/api-reference/links/get-post)
+- [`/links.list`](/beta/api-reference/links/list-post)
+
+Changes:
+- Added `meeting` as a valid type for link source/target objects
+- Added meeting summary schema support
+
+## Search
+
+### Modified Response Schema
+The following endpoints have updated search results schema to include meeting support in links:
+
+- [`/search.core`](/beta/api-reference/search/core-post)
+- [`/search.hybrid`](/beta/api-reference/search/hybrid-post)
+
+Changes:
+- Added meeting support in link search results through new `meeting` type
+
+## SLAs
+
+### Modified Response Schema 
+The following endpoints have updated SLA tracking schemas:
+
+- [`/sla-trackers.get`](/beta/api-reference/slas/sla-trackers-get-post)
+- [`/sla-trackers.list`](/beta/api-reference/slas/sla-trackers-list-post)
+- [`/slas.create`](/beta/api-reference/slas/create)
+- [`/slas.get`](/beta/api-reference/slas/get-post)
+- [`/slas.list`](/beta/api-reference/slas/list-post)
+- [`/slas.transition`](/beta/api-reference/slas/transition)
+- [`/slas.update`](/beta/api-reference/slas/update)
+
+Changes:
+- Added `account_filter` property to SLA schema
+- Added `applies_to_type` property to SLA tracker
+- Added `completed_at` property to metric target summaries
+
+## Timeline Entries
+
+### Modified Response Schema
+The following endpoints have updated timeline entry schemas to support meetings:
+
+- [`/timeline-entries.create`](/beta/api-reference/timeline-entries/create)
+- [`/timeline-entries.get`](/beta/api-reference/timeline-entries/get-post)
+- [`/timeline-entries.list`](/beta/api-reference/timeline-entries/list-post)
+- [`/timeline-entries.update`](/beta/api-reference/timeline-entries/update)
+
+Changes:
+- Added meeting support in timeline events through new `meeting` type in source/target links
+
+## Works 
+
+### Modified Parameters
+The following endpoints have new state filtering capabilities:
+
+- [`/works.export`](/beta/api-reference/works/export-post)
+- [`/works.list`](/beta/api-reference/works/list-post)
+
+Changes:
+- Added `state` query parameter for filtering
+
+### Modified Response Schema
+The following endpoints have updated work schemas with SLA tracking improvements:
+
+- [`/works.create`](/beta/api-reference/works/create)
+- [`/works.export`](/beta/api-reference/works/export-post)
+- [`/works.get`](/beta/api-reference/works/get-post)
+- [`/works.list`](/beta/api-reference/works/list-post)
+- [`/works.update`](/beta/api-reference/works/update)
+
+Changes:
+- Added `applies_to_type` property to SLA tracker
+- Added `completed_at` property to metric target summaries
+
+## Webhooks
+
+### Modified Request Schema
+The [`/webhooks.event`](/beta/api-reference/webhooks/event) endpoint has updated webhook event schemas to include all the above schema changes for affected objects.

fern/apis/public/changelog/2025-01-17.md

@@ -2,17 +2,17 @@
 # API Changes
 
 ## SLA Trackers
-The following endpoints have been updated with new properties in the SLA tracker schema:
+The following endpoints have updated SLA tracker responses with new properties:
 - [`/sla-trackers.get`](/public/api-reference/slas/sla-trackers-get-post)
 - [`/sla-trackers.list`](/public/api-reference/slas/sla-trackers-list-post)
 
 Changes:
 - Added `applies_to_type` property to SLA tracker schema
 - Added `completed_at` property to metric target summaries
 
-## SLAs 
-The following endpoints have been updated with new properties in the SLA schema:
-- [`/slas.create`](/public/api-reference/slas/create)
+## SLAs
+The following endpoints have been updated with new SLA properties:
+- [`/slas.create`](/public/api-reference/slas/create)  
 - [`/slas.get`](/public/api-reference/slas/get-post)
 - [`/slas.list`](/public/api-reference/slas/list-post)
 - [`/slas.transition`](/public/api-reference/slas/transition)
@@ -29,4 +29,14 @@ The following endpoints have been updated:
 Changes:
 - Added new query parameter `state` to filter works
 
-All work-related endpoints have also been updated to include the new SLA tracker schema changes mentioned above in their responses.
+The following endpoints have updated work responses with modified SLA tracking information:
+- [`/works.create`](/public/api-reference/works/create)
+- [`/works.get`](/public/api-reference/works/get-post)
+- [`/works.update`](/public/api-reference/works/update)
+
+## Webhooks
+The following endpoint has been updated:
+- [`/webhooks.event`](/public/api-reference/webhooks/event)
+
+Changes:
+- Updated webhook event payloads to include new SLA tracking properties (`applies_to_type` and `completed_at`) in work and conversation objects