Willow API
The Willow API allows you to programmatically manage MCP servers and other resources in your organization.
Authentication
All API endpoints require authentication using a Bearer token. You can generate API tokens from the Admin Settings in your Willow dashboard.
Include your token in the Authorization header:
Authorization: Bearer wxt_xxxxx
See API Tokens for more details on generating and managing tokens.
Versioning and deprecation
This is version 1 of the Admin API. Every endpoint accepts an optional Willow-API-Version header; omitting it means version 1. New endpoints and fields are added without a version change. Breaking changes ship only under a new version, and an operation is removed no sooner than 6 months after it is deprecated. Deprecated operations are marked deprecated: true in the spec and return Deprecation and Sunset response headers.
See API Versioning and Deprecation for the full policy.
Permission Scopes
API tokens can be created with specific permission scopes to limit their access. When generating a token, select one or more scopes:
| Scope | Description |
|---|---|
all | Full access to all API operations |
admin:read | Read-only access to admin resources (MCP Servers, Toolkits, Skills, Guards, Users, Groups, Commands, Background Agents, AI Discovery) |
admin:write | Read & write access to admin resources (includes admin:read and admin:scim) |
admin:scim | SCIM provisioning access only (Users and Groups via SCIM) |
connect:read | Read-only access to user-scoped resources via the User API |
connect:write | Read & write access to user-scoped resources (includes connect:read) |
Scope Hierarchy
allgrants every scope.admin:writeautomatically includesadmin:readandadmin:scim.connect:writeautomatically includesconnect:read.
Required Scopes by Endpoint
| Endpoints | Read (GET) | Write (POST/PATCH/DELETE) |
|---|---|---|
| MCP Servers, Toolkits, Skills, Guards, Users, Groups, Commands, Background Agents | admin:read | admin:write |
| AI Discovery (discovered MCP servers, skills, memory, devices, agents, stats, enforcement policy) | admin:read | admin:write |
SCIM (/scim/v2/*) | admin:scim | admin:scim |
| User API (User MCP Servers, Toolkits, Skills, Commands, etc.) | connect:read | connect:write |
Authentication
- HTTP: Bearer Auth
API token authentication. Tokens are prefixed with wxt_ and can be generated from Admin Settings.
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |