PolyAPI - Release 12

Release Notes

June 27, 2024
Days since last major release: 30 days

Poly API Snippets – Published an initial set of TypeScript Snippets to get started with Poly:
- Make your first API call with Poly.
- Build a custom function.
- Receive webhook events.
- Validate JWT tokens.
- Implement Error handling and logging.
Bug Fixes
- Type Imports – Resolved local dependency issues in server functions.

Webhook Improvements – Added default blocking and handle-based webhook methods for improved control and flexibility, allowing listeners to remain active until interrupted or to be easily closed when needed.
Optional Headers and Params – Made headers and parameters optional in server function execution, providing flexibility in how functions handle events, headers, and parameters.
New Functions – Added ‘Delete’ function and ‘Add Server Variable’ functionality.
Bug Fixes
- Java Library – Resolved an issue where running ’mvn clean compile’ failed if an API function returned a JSON object with keys containing spaces, such as “api key”.
- Primitive Types Handling – Fixed an issue preventing server functions from accepting primitive types as arguments.

Type Improvement – Updated Python client import paths to align with TypeScript, changing types previously imported from modules with a leading underscore, for example ‘from _foobar’ to ‘from Foobar’.

API Functions – Added generation and execution capabilities for API Functions in C#, including getting started documentation.

Expanded Management UI – Added API functions, Server functions, and Client functions pages to Poly’s Management UI.
Canopy Configuration Update – Updated to use context + function name for consistent setups across all environments, standardizing Canopy configuration.

Conversations List API – Added /assistants/{slug}/conversations list endpoint to view all conversations for a specific AI assistant, initially available to super users.
Detailed Conversations Endpoint – Added GET /assistants/{slug}/conversations/{conversation_id} endpoint to retrieve specific conversation details by ID.
Bug Fixes
- API Function Response Modeling – Resolved an issue where the AI assistant failed to recognize ApiFunctionResponse behind .data

OAS Training Guide – Added a guide on training API functions and webhooks using OpenAPI Specifications. View here
Postman Training Guide – Added a guide on using Postman for API function training using pre and post-request scripts. View here.
Generated SDKs – Added SDK’s for TypeScript, Java, and Python to help developers get started with Poly in their language of choice. View here.

Instance URL Configuration – Added the ability to more easily set an instance URL in Postman pre-request script, defaulting to NA1 and configurable in the pre-request script. Automatically adjusts to eu1 for European download script endpoints.
Bug Fixes
- Bearer Token Handling – Resolved issues with invalid Bearer token objects from Postman causing poly training call failures.

Accelerated Deployment – Improved deployment speed for server functions with external dependencies, reducing initial deployment and redeployment times, and added visibility into deployment progress.
Tenant Functions in Jobs – Added support for tenant and public functions in jobs, allowing them to be published with various visibilities (environment, tenant, public).
Redeployment Enhancement – Improved logic to keep current functions active until new versions are ready, avoiding downtime during function redeployment.

Apaleo PMS: Published 282 API & Webhooks Functions for full coverage of APIs
Opera Cloud PMS: Published 14 new OHIP API Functions in cashiering, reservations, configuration, deposits.

Server Function Usage Dashboard – Added a second table to the server function dashboard for self-hosted customers, displaying currently running server functions on Knative, including names, IDs, context, run start time, number of nodes in use, and sleep cycle details.