PolyAPI  >  Developers  >  Release Notes

PolyAPI – Release 21

Release Notes 

March 27, 2025
Days since last major release: 30 days

Node Client

Improvements

  • Name sanitization – Made an enhancement to change dashes to camel case notation when training APIs and Webhooks via OpenAPI specs.
  • Response Headers – Added ability to set custom response headers using polyCustom in server functions. 

Bug Fixes

  • Duplicate Arguments – Fixed a bug sometimes causing duplicate arguments when training functions via OpenAPI Schemas
  • Enum Types – Fixed a bug where enum types would cause the generation of types to fail in the TypeScript client SDK. 
  • Axios Version – Bumped ‘axios’ dependency version to more secure version

Python Client

Improvements

  • [PREVIEW 0.3.3.dev4] Python Client – generate Schemas inside the Python client. Add correct types for API Functions that use Schemas. This capability will be released within the coming 1-2 weeks outside of a major release cycle. 

Server & API

Improvements

  • Schemas Import Path – updated Typescript Schema import path to be schema.myContext.mySchema See documentation here.
  • Public Schemas – Added ability to make schemas public visibility to be used by others. 
  • Jobs – Jobs serialized in the API and displayed in the PolyUI canopy application show the max allowed time they may take to execute and the max number of concurrent instances of the job that can run at one time. Jobs that exceed the max time are cut short. Customers that need longer job execution windows should reach out to support. 
  • API Functions Payload Size Limits – Sometimes the JSON payloads returned by an API function, or sent to an API function can be quite large and cause errors when training these to Poly. We now detect JSON payloads that are too large and limit the JSONSchema types we generate to prevent any errors in training.
  • Training API Functions with Files – Added support for training API functions that accept as an argument or return binary file payloads.
  • Trigger Cleanup– delete triggers when the associated server function is deleted
  • Function Replication with Schemas – Enhanced Function replication to support replicating associated schemas as well. 
  • Public Function Replication – Enhanced replication of public functions into one’s own environment to include schemas when replicating to another environment.
  • Owners for Other Functions Types: Added owner fields to all functions types, can now be linked to users.
  • Async Server Functions – add new `serverSideAsync` option to enable longer duration Server Functions. Users should poll them periodically to check for completion and get the results.

Bug Fixes

  • Expires At for Variables – Fixed a bug where expires at variable field should be optional. 
  • Schema Name – Added name as a required field when creating schemas. 
  • Unintended Logging – Fixed a bug where logs were collected for server functions with logsEnabled:false if executed via a webhook.
  • Webhook Endpoints – Fixed bug with webhooks with slugs not being ready for use immediately after creation.
  • Updating Permission Policies – Fixed a bug where adding an environment to an existing permission policy would 500.

Canopy Service (and Poly Management UI)

Improvements

  • Improved Search – for API functions, added new search functionality and pagination for faster loading. Will be deprecating specific pages for public resources over time.   
  • Error Page – When we attempt to fetch the details of a collection item and fail to find it we now show an error page rather than silently redirecting back up to the collection list view.
  • Better 401 Message – Improved the error message when getting an unauthorized access message in a canopy app. 
  • Owners and State – Exposed Function Owners and Lifecycle stage in the management UI. 

Bug Fixes

  • Collapsable item tooltips – Fixed a bug with collapsible items with tooltips in canopy detail views where attempting to click a button within the tooltip would collapse the section inadvertently.
  • Number Inputs on Execute – Fixed a bug where canopy was not handling number inputs correctly in the execute function page. 
  • Environment Switching – Fixed a bug to allow for switching environments within canopy when using permission policies. 
  • Placeholder Text – Fixed a bug where canopy configurations for placeholder text were not showing. 
  • API Key Creation – Fixed a bug API keys created in environments outside the admin primary env were throwing a 404 after creation. 
  • Page Crashing on 500s – Fixed a bug where canopy pages in custom apps backed by server functions would crash if the server function returns a 500. 
  • SSO 404 – Fixed a bug where SSO flow was throwing a 404 on the last step of logging in. 
  • Tenant Admin Page – Adjusted tenant details page to show all visible fields to an admin, and update form to show only editable fields.
  • ReturnType Change – Fixed a bug where void response types were changed to Object when updated via the Management UI. 
  • Login Enter Key – Fixed a bug where enter was not the same as pressing the log in button on the canopy login page. 

VS Code Extension

Improvements

  • Python Snippets – Updated extension and python client so that python snippets appear in the VS Code extension tree ready to copied and used
  • Management UI Link – Added a link from the Poly Tree in the VS Code Extension to the Canopy UI page for the function.

AI Services

Improvements

  • Schema Injection – The Assistant is now aware of Schemas and will pull the types in and use them when generating code and answering questions about code.
  • Better Type Checking – add more and better types to our Python codebase for internal type checking (mypy)

Docs, Public Functions and Content

Documentation

  • SSO Setup – Added documentation to outline the step by step process of setting up SSO. 
  • Canopy App Config – Added documentation on how to configure Canopy Applications
  • Schema Docs – Documentation explaining how schemas work and how to use them.  
  • API Spec – Added request body schema and example to PATCH /schemas/{id} to fix missing Swagger UI details.

OOB Functions

  • poly.OOB.google.cloud.objects.insert() – to upload binary files to Google Cloud Storage with metadata returned
  • poly.OOB.google.cloud.oauth2.getToken() – to generate OAuth 2.0 access tokens using JWT bearer assertions for secure Google API authentication.
  • ohip.crm.profiles.v2.getDetails – as a new version of the original function, with support for an optional headers object (including x-externalsystem) to allow custom headers.
  • Added 20 Tixr API operations as OOB functions, including Groups, Events, Orders, Fans, Fan Transfers, Custom Forms, and Custom Form Submissions APIs. 

Infrastructure/DevOps Improvements

Improvements

  • Server Functions – upgrade server function framework (Knative) to latest version in all environments (1.17)
  • Endpoint Security – implement improved IDS and network firewall
  • Server Function Refresh – add internal mechanism for refreshing server functions to take advantage of latest logging improvements and bug fixes.
  • DB Monitoring – add better monitoring and alerting around PostgreSQL Connections