REST authentication

REST authentication is configured at the connection level and selected at the query level.

Supported auth types in Connections

• Basic: username/password
• Bearer: token-based header
• OAuth2 (Client Credentials): machine-to-machine token flow

Configure authentication on a connection

1. Open Settings > Connections > APIs
2. Open your connection
3. Go to Authentication
4. Click Add authentication
5. Select auth type
6. Fill required fields
7. Click Save

You can store multiple auth configs on one connection.

Select auth in a query

1. Open connection in API Editor
2. Open/create a query
3. Select auth config for the query
4. Click Send
5. Save query

Auth configuration guidance

• Create separate auth entries per environment when needed.
• Use clear names (Prod Bearer, Staging OAuth2).
• Re-test all affected queries after editing a shared auth config.

Using SSO token bindings

If SSO is configured, you can bind the current user token in request fields.

{{ Current User.OAuthToken }}

Common usage:

• Authorization header values
• Request body fields for delegated APIs
• Request params in legacy endpoints

Troubleshooting matrix

Related guides

• REST OAuth2
• REST queries
• OpenID Connect