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

Retool Folders API

Organize apps, resources, and workflows into folders for better team organization.

Retool Folders API is one of 7 APIs that Retool publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Folders. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 2 operations across 1 path, and defines 4 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against a single base URL, https://api.retool.com/v1.

2 operations 1 paths 4 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Server
https://api.retool.com/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Retool Folders API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Bearer token generated in Retool workspace settings under API Access Tokens. Format: Authorization: Bearer

Paths & Operations 2

Across 1 path, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Folders 2

Organize apps, resources, and workflows into folders for better team organization.

GET
/folders
List Folders
listFolders 1 param → 200401403500
POST
/folders
Create Folder
createFolder body → 201400401403500

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Folder (5 properties), CreateFolderRequest (3 properties), Error (2 properties), FolderListResponse (1 property). Each schema is shown below with its type and property counts.

Folder
object
A Retool folder for organizing apps, resources, or workflows.
5 properties
Error
object
An error response.
2 properties
FolderListResponse
object
List of folders.
1 property
CreateFolderRequest
object
Request body for creating a new folder.
3 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

retool-folders-api-openapi.yml Raw ↑

Other APIs Retool publishes across the network.

Retool SCIM 2.0 API
Retool Platform
Retool Apps API
Retool Groups API
Retool Resources API
Retool Users API