PolyAPI  >  Developers  >  Release Notes

PolyAPI – Release 17

Release Notes 

November 26, 2024
Days since last major release: 28 days

Client Improvements

Node

Improvements

  • Gitlab Support – Bringing the Project Glide deployment workflow to Gitlab for out of the box git-driven CI/CD of PolyAPI functions.
  • Glide Webhooks– Project Glide deployment workflow now supports webhooks. The client will now automatically find and deploy webhooks you define in your code repository.
  • SFX Execution Key (TS)  – Ability to set an execution key for server functions independent of the developer key being used to deploy the function. 
  • Performance – improvements to speed up commands.
  • Text Improvements – Improved function deploy text in TS client for clarity.
  • Function training – Improved type inference when training functions with untyped arguments by inferring the type from the default value if one is provided.

Bug Fixes

  • Union Types – fixed a bug where, when using union return types, Poly would sometimes fail to detect the type and fallback to `any`

Python

Improvements

  • Glide – Added support for Project Glide workflow in the Python language client with two new commands `python -m polyapi prepare` and `python -m polyapi sync` that empower this workflow.
  • SFX Execution Key (Python) – Ability to set an execution key for server functions independent of the developer key being used to deploy the function. 
  • Setup Command – updated the `setup` command to be smoother and more robust.
  • Logs Enabled – made the `–logs` command more explicit. You now specify `–logs=enabled`
    or `–logs=disabled` 

VS Code Extension

Improvements

  • Extension Grouping – Improved the editor interfaces to standardize all panel titles under the “Poly” name for streamlined user experience.

Canopy Service (and Poly Management UI)

Improvements

  • Schemas UI – Added interface to browse trained schemas, create new schemas, and update or delete existing schemas. 
  • Webhook Execution – Using the Canopy UI, can now execute and provide values for each parameter.
  • API Function Updates – Improved validation on API function training to prevent invalid empty JSON bodies from being submitted.
  • Linking – Improved canopy to allow for linking from third party web apps like Google Docs and Office 365 into a canopy application without redirecting the user to the login page.
  • New TOS – Added new Terms of service to application at signup.

Server & API

Improvements

  • SFX Wakeup Times – Server functions with custom dependencies wake from sleep much faster.
  • Activity History – Variable and trigger create, update, delete operations are now. written to activity history. Values for variables are omitted to protect sensitive info. 
  • Storing All OAS Responses – at the time of training Poly with OpenAPI Specs, to allow for more comprehensive future models without retraining. 
  • XML Parsing – Added support for parsing XML events sent to webhooks with subpaths.

Bug Fixes

  • Webhooks Custom Status Codes – bugfix to support custom response codes set dynamically within server functions via `polyCustom`
  • Null Response – Fixed bug where server functions would return an empty string instead `null`.
  • Folder Cleanup – when deleting server functions, all respective directories which stored containers are also deleted if empty. 
  • Negative Metrics – Fixed a bug where latency numbers were being returned as negative numbers.
  • Metrics Collection – Fixed a bug where metrics were not being collected on environments after being updated.
  • Function Types – Improved API and service handling of `typeSchema` properties so they’re always returned as a JSONSchema object instead of an unparsed JSON string.

AI Services

Improvements

  • Help with Docs – /p and /poly have been updated to use the same source documentation as our documentation site docs.polyapi.io, greatly improving AI Assistants ability to help end users. 
  • Configurations – Added a few missing configurations to EU1 and NA2 to optimize AI Agent Performance. 

Bug Fixes

  • API Keys – Fixed a bug where copilot chat was not asking for a new developer key when switching VS Code projects. 

Docs, Public Functions and Content

OOB Functions

  • OHIP Functions – Added several OHIP APIs for managing profiles, export mappings, and transaction codes:
    • poly.OOB.ohip.crm.profiles.create(),
      poly.OOB.ohip.crm.profiles.update(),
      poly.OOB.ohip.crm.profiles.search()
    • poly.OOB.exportMappings.config.linkedTypes.update()
    • poly.OOB.frontDesk.config.transactionCodes.getDetails()
  • PolyAPI Functions – Improved PolyAPI’s own out of the box (OOB) functions to ensure all are well documented with descriptions for functions and any arguments.

Documentation

  • Overview – Improved documentation adding Platform Overview to give a higher level overview of PolyAPI and all its primary resources.
  • Cron Jobs – improved docs around cron jobs, clarified values should be provided in Zulu time. https://docs.polyapi.io/jobs/managing.html#create-a-job-name-and-schedule 

Postman Collection 

  • Reusable Schemas – Added CRUD operations and specialized functionalities for managing reusable schemas. 
  • Permission Updates – Added the managedSchemas permission to the payloads for the following endpoints:
    • PATCH/tenants/{id}/environments/{environmentId}/api-keys/{apiKeyId}
    • POST /tenants/{id}/environments/{environmentId}/api-keys
  • Environment Configuration Updates –   Updated the POST and PATCH payloads for /tenants/{id}/environments to include previously missing fields:
    • logsDefault
    • metricsEnabled

Marketplace Listings

  • PolyAPI Event Streaming and Orchestration for OHIP is now available, enabling hospitality teams to efficiently capture, process, and orchestrate OHIP events. View the listing: here.
  • Zoom Phone to Hospitality Cloud Integration by PolyAPI  is now available, supporting bidirectional data exchange between Zoom Phone and Oracle Hospitality Cloud to streamline hotel operations such as guest check-ins, call tracking, real-time billing, and data cleanup after guest checkouts. View the listing: here.

Infrastructure/DevOps Improvements

Improvements

  • Poly Gateway Autoscaler: switch to a more efficient autoscaler to improve response times, throughput, and efficiency.