Microsoft Excel Sandbox

This is sandbox for the Microsoft Excel Sandbox API, using an OpenAPI specification with examples, Microcks and Bruno as the sandbox interface, and this GitHub repository as the vehicle for delivering as a localized sandbox, or also enabling the working directly with production APIs.

APIs.json Index

There is an APIs.yml file in the root of this repository, providing an index of all the artifacts used as part of this capability, providing a machine-readable way to read, manage, and execute the resources available here.

OpenAPI

This capability uses OpenAPI as the definition, providing a complete definition of all available paths for the Microsoft Excel Sandbox. The OpenAPI for this capability uses examples and Microcks extensions to mock the requests and responses for each API operation, something we will iterate and expand upon with richer examples as the capability evolves.

Microcks

This capability uses Microcks to deliver the mock API. You just install Microcks, with the Docker extension being the easiest, import the OpenAPI as a service, and you have a mocked API for all APIs, available via REST and MCP APIs--providing a multi-protocol sandbox.

Bruno

This capability uses Bruno as the client, leveraging Bruno Collections pre-generated from the OpenAPI and Bruno environments that uses the localhost and port of Microcks to work with the mocked API. You just have to install Microcks, then open the collection provided in this repository, select the available environments, and begin calling the Microsoft Excel Sandbox via the sandbox or production.

OpenAPIs

These are the OpenAPIs available for the Microsoft Excel Sandbox, which are made available via this sandbox API, which can be imported into Microcks and deployed as a sandbox using their mock feature.

• Microsoft Excel Openapi.yaml

Agent Skills

These are the agent skills available for the Microsoft Excel Sandbox, providing a discrete list of capabilities that AI agents can use when working with Microsoft Excel files via OneDrive and SharePoint. Each skill maps directly to an OpenAPI operation, making it easy for agents to discover and invoke the right capability for a given task.

Uploads

• Upload Excel File (uploadFile) — Upload or replace an Excel workbook in OneDrive using a simple PUT request for files smaller than 4 MB.
• Create Upload Session (createUploadSession) — Initiate a resumable upload session for large Excel files (greater than 4 MB) to enable reliable chunked byte-range transfers.
• Create File or Folder Entry (createChildItem) — Create a new empty file placeholder or folder as a child item under a specified OneDrive parent folder.

Content

• Download File Content (getFileContent) — Download the binary content of an Excel workbook, with optional server-side conversion to PDF, HTML, JPG, or PNG.

Metadata

• Get File Metadata (getDriveItem) — Retrieve metadata for a specific Excel file or folder by its OneDrive item ID, including name, size, timestamps, author, and download URL.
• Update File Metadata (updateDriveItem) — Update writable properties on an Excel file such as its name, description, or parent folder location for moving.
• Delete File (deleteDriveItem) — Soft-delete an Excel file or folder by moving it to the OneDrive recycle bin, where it can be restored within the retention period.

Permissions

• List File Permissions (listItemPermissions) — Retrieve all sharing permissions currently applied to an Excel file or folder, including roles for users, groups, and links.
• Get Specific Permission (getItemPermission) — Retrieve details for a single sharing permission on an Excel file by its permission ID.
• Update Permission Role (updateItemPermission) — Change the role of an existing sharing permission, such as downgrading a collaborator from write to read access.
• Remove Permission (deleteItemPermission) — Revoke a specific sharing permission from an Excel file or folder by its permission ID.
• Share via Invitation (inviteItemRecipients) — Grant permissions and optionally send an email sharing invitation to specified recipients with configurable roles and sign-in requirements.
• Create Sharing Link (createSharingLink) — Generate an anonymous or organizational sharing link for an Excel file with configurable type, scope, optional password, and expiration date.

Document Locks

• Check Out File (checkoutItem) — Lock an Excel workbook for exclusive editing by the current user, making it read-only for others until checked back in.
• Check In File (checkinItem) — Release the exclusive lock on a checked-out Excel file and optionally publish a new version with a descriptive comment.

Search

• Search OneDrive (searchDriveItems) — Search file names, metadata, and indexed content within the signed-in user's OneDrive to find Excel workbooks.
• Search via Microsoft Search (microsoftSearchQuery) — Use the Microsoft Search API with KQL syntax to find Excel files across OneDrive and all SharePoint sites the user has access to.

Support

Please provide any questions or feedback via GitHub issues, or just email kinlane@naftiko.io with feedback. The goal is to keep iterating upon this sandboxes using existing OpenAPI, Microcks, and Bruno features, offering value out of the box via this forkable capability.