Retool API
Programmatically manage your organization using Retool's REST API.
| Retool API Availability | |||
|---|---|---|---|
| Cloud | Generally Available | ||
| Self-hosted Edge 3.36 or later | Generally Available | ||
| Self-hosted Stable 3.33 or later | Generally Available | ||
The Retool API enables you to perform actions across your organization or its spaces. You can perform RESTful requests to manage a wide range of objects, such as adding users or updating resource configurations.
Availability
The Retool API is available to both cloud- and self-hosted organizations on a Business or an Enterprise plan. The endpoints available depend on your organization's pricing plan. Available endpoint categories include:
| Feature | Business | Enterprise |
|---|---|---|
| User Invites | ✓ | ✓ |
| User Attributes | ✓ | ✓ |
| Custom Component Library | ✓ | ✓ |
| Source Control operations | ✓ | |
| Group User Invites | ✓ | |
| Workflow Run details | ✓ | |
| User Management, Groups, Folders, Spaces | ✓ | |
| App Themes, SSO Configuration, Permissions | ✓ | |
| Resources, Environments, Configuration Variables | ✓ | |
| Observability, Usage Analytics, Organization Settings | ✓ |
Organizations on an Enterprise plan should contact their account manager for full information about available endpoints.
Base URL
All endpoints are relative to your Retool instance URL:
https://{your-retool-instance}/api/v2
Authentication
The Retool API uses HTTP Bearer authentication scheme with API tokens to authenticate requests. Users with sufficient permissions can create API tokens in the organization's Retool API settings. Each token can be scoped to specific permissions—only grant the scopes needed for your use case.
Authorization: Bearer YOUR_API_TOKEN
Versioning
The API version corresponds to the Retool release version currently in use. Cloud-hosted instances always use the latest version of Retool.
For hosted instances, such as self-hosted deployments, the API version reflects the features and endpoints available in the release currently deployed. When you upgrade your Retool instance, the API version updates alongside it and any new endpoints or capabilities introduced in that release become available.
API reference
A complete API reference is available at