Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Windmill folder API

The folder API from Windmill — 11 operation(s) for folder.

Windmill folder API is one of 59 APIs that Windmill publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include folder. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and authentication docs.

This API exposes 11 operations across 11 paths, and defines 2 schemas. It is described by OpenAPI 3.0.3, at version 1.694.0.

Requests are made against a single base URL, /api.

11 operations 11 paths 2 schemas 1 DELETE6 GET4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.694.0
Base URL
https://app.windmill.dev/api
Authentication
HTTP Bearer, API Key
License
Resource Areas
1

Authentication & Security 2

Windmill folder API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). An API key is passed in the cookie as token (cookieAuth). By default, every request must be authenticated.

Paths & Operations 11

Across 11 paths, the API surfaces 11 operations — 1 DELETE, 6 GET, 4 POST. Each is listed below with its method, path, parameters, and response codes.

folder 11
GET
/w/{workspace}/folders/list
List Folders
listFolders 3 params → 200
GET
/w/{workspace}/folders/listnames
List Folder Names
listFolderNames 2 params → 200
POST
/w/{workspace}/folders/create
Create Folder
createFolder 1 param body → 200
POST
/w/{workspace}/folders/update/{name}
Update Folder
updateFolder 2 params body → 200
DELETE
/w/{workspace}/folders/delete/{name}
Delete Folder
deleteFolder 2 params → 200
GET
/w/{workspace}/folders/get/{name}
Get Folder
getFolder 2 params → 200
GET
/w/{workspace}/folders/exists/{name}
Exists Folder
existsFolder 2 params → 200
GET
/w/{workspace}/folders/getusage/{name}
Get Folder Usage
getFolderUsage 2 params → 200
POST
/w/{workspace}/folders/addowner/{name}
Add Owner to Folder
addOwnerToFolder 2 params body → 200
POST
/w/{workspace}/folders/removeowner/{name}
Remove Owner to Folder
removeOwnerToFolder 2 params body → 200
GET
/w/{workspace}/folders_history/get/{name}
Get Folder Permission History
getFolderPermissionHistory 4 params → 200

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed is Folder (7 properties). Each schema is shown below with its type and property counts.

Folder
object
7 properties 3 required
FolderDefaultPermissionedAs
array
Ordered list of rules applied at create-time when admins or wmdeployers members deploy items in this folder. The first rule whose pathglob matches the item pat…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

windmill-folder-api-openapi.yml Raw ↑

Other APIs Windmill publishes across the network.

Windmill admin API
Windmill agent_workers API
Windmill app API
Windmill asset API
Windmill audit API
Windmill azure_trigger API
Windmill capture API
Windmill concurrencyGroups API
Windmill config API
Windmill documentation API
Windmill draft API
Windmill email_trigger API