Skip to content

chore: Update OpenAPI specs #219

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
May 19, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion changelog.py
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ def main(vrn, d):
print('Sending request to LLM.')
l = llm_client.get_response(p)
log_file = f"./fern/apis/{vrn}/changelog/{d}.md"
if (l):
if (l) and 'Error' not in l.partition('\n')[0]:
with open(log_file, 'w', encoding="utf-8") as outfile:
outfile.write(llm_client.get_lines_between_tags(l, 'changelog'))
print(f"Wrote log to {log_file}.")
Expand Down
78 changes: 78 additions & 0 deletions fern/apis/beta/changelog/2025-05-19.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
## New Endpoints

### Artifacts
- [`/artifacts.versions.delete`](/beta/api-reference/artifacts/hard-delete-version): Delete an artifact version

### Brands
- [`/brands.create`](/beta/api-reference/brands/create): Create a new brand
- [`/brands.delete`](/beta/api-reference/brands/delete): Delete an existing brand
- [`/brands.get`](/beta/api-reference/brands/get-post): Get the information for a brand
- [`/brands.list`](/beta/api-reference/brands/list-post): List brands matching a given filter
- [`/brands.update`](/beta/api-reference/brands/update): Update an existing brand

### Links
- [`/links.replace`](/beta/api-reference/links/replace): Replace a link

### Metrics
- [`/metric-trackers.get`](/beta/api-reference/slas/metric-trackers-get-post): Get a metric tracker

## Modified Endpoints

### Accounts
- Added `subtype` and `tier` query parameters to [`/accounts.export`](/beta/api-reference/accounts/export-post) and [`/accounts.list`](/beta/api-reference/accounts/list-post)
- Added `drop` property to `custom_schema_spec` in [`/accounts.create`](/beta/api-reference/accounts/create) and [`/accounts.update`](/beta/api-reference/accounts/update)

### Articles
- Added `content_format` and `data_sources` properties in [`/articles.create`](/beta/api-reference/articles/create-article) and [`/articles.update`](/beta/api-reference/articles/update-article)
- Made `applies_to_parts` optional in [`/articles.create`](/beta/api-reference/articles/create-article)

### Commands
- Added `ai_assistant_chat` and `dm` to allowed object types in surface configuration for [`/commands.create`](/beta/api-reference/commands/create), [`/commands.update`](/beta/api-reference/commands/update) and related endpoints

### Conversations
- Added `state` query parameter to [`/conversations.list`](/beta/api-reference/conversations/list-post) and [`/conversations.export`](/beta/api-reference/conversations/export-post)
- Modified `owned_by.set` to allow empty arrays in [`/conversations.update`](/beta/api-reference/conversations/update)

### Groups
- Added filtering by `created_by`, `name`, and `sync_metadata` fields to [`/groups.list`](/beta/api-reference/groups/list-post)

### Links
- Added `custom_link_type` property to link objects in [`/links.create`](/beta/api-reference/links/create) and related endpoints

### Meetings
- Added `sync_metadata` property to meeting objects in [`/meetings.create`](/beta/api-reference/meetings/create) and related endpoints

### Opportunities
- Added `contacts` property to opportunity objects in work-related endpoints

### SLAs
- Added `subtype` and `tier` properties to account selector in [`/slas.create`](/beta/api-reference/slas/create) and [`/slas.update`](/beta/api-reference/slas/update)

### Webhooks
- Added `sla_tracker_fetched` event type to [`/webhooks.create`](/beta/api-reference/webhooks/create), [`/webhooks.update`](/beta/api-reference/webhooks/update) and related endpoints

### Widgets
- Added `combination` visualization type
- Removed `percentage_precision` from PVP metric configuration

## Schema Changes

### Custom Schema Spec
Added `drop` property to `custom_schema_spec` in multiple endpoints including:
- Account endpoints
- Article endpoints
- Chat endpoints
- Code change endpoints
- Conversation endpoints
- Custom object endpoints
- Dev user endpoints
- Incident endpoints
- Meeting endpoints
- Part endpoints
- Work endpoints

### Meeting Summary
Added new subschema to meeting summary objects affecting multiple endpoints that reference meetings

### Link Summary
Modified link summary schema to support custom link types across multiple endpoints
Loading
Loading