Skip to main content
Version: 1.0.0

Retool SCIM 2.0 API

Retool implements a subset of the SCIM 2.0 REST API that is required to work with IDP vendors like Okta. If required, it's also possible to use these APIs directly to have your own custom user and role management system.

Base URL

All SCIM API endpoints are available at /api/scim/v2/. The full base URL includes the URL for your Retool cloud or self-hosted instance, such as https://retool.example.com/api/scim/v2/. To perform actions on a child Space, use its domain, e.g., https://retool-docs-space.example.com/, instead of the admin Space domain.

Authentication

The SCIM 2.0 API uses Bearer (token) authentication. You must provide your Retool API token with all API requests. See the SCIM user provisioning guide to learn how to create an access token.

Pagination

The SCIM 2.0 API does not support pagination. Parameters such as count and startIndex are ignored.

Authentication

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer