Appearance
API Reference
This page indexes the complete set of APIs available to a tool running inside Power Platform ToolBox. Use it as a map: each API below covers a distinct capability, and the detailed reference for each lives on its own page.
Everything a tool can do — talk to the host shell, read/write Dataverse, call Power Platform service endpoints, persist settings, touch the file system, or react to platform events — goes through one of these documented APIs; there is no undocumented back channel into the host.
API categories
- ToolBox API — platform features including connections, utilities, and terminal management.
- Dataverse API — complete HTTP client for interacting with Microsoft Dataverse.
- PowerPlatform API — direct access to Power Platform service endpoints and management operations.
- Events API — subscribe to platform events like connection changes and settings updates.
- Settings API — persistent storage for tool-specific preferences and configuration.
- File System API — secure file operations for reading, writing, and managing files.
- Error Handling — best practices for handling errors gracefully.
For complete TypeScript definitions covering all of the above, install the @pptb/types package:
bash
npm install --save-dev @pptb/typesGetting started path
For developers new to PPTB, the documentation recommends this sequence:
- Quickstart Guide — get up and running quickly.
- ToolBox API — learn about platform features.
- PowerPlatform API — call Power Platform service endpoints.
- Dataverse API — start interacting with Dataverse.
- Error Handling — implement robust error handling.