Skip to content

Read this org’s OAuth application for a connector

GET /connector/{slug}/oauth-app

Whether connects on this connector use Elaichi’s platform application or one this organization supplied, and the client id if so. The client secret is never returned — `has_client_secret` reports only whether one is stored. Answers `404` for a connector this organization owns (edit its credentials with `PATCH /connector/{slug}` instead) and, for every other connector, unless the connector needs a customer OAuth application (`byoa: true` on `GET /connector/{slug}`) OR this organization already has one stored (`oauth_app_mode: "byoa"`) for it — a stored override stays reachable even after the catalog stops requiring one. There is no separate field for this on `GET /connector/{slug}` — a client reads this endpoint directly: a `404` here means no organization OAuth application applies to this connector and the override UI should not be offered; any other response means it should. Requires `connector:manage`.

Path Parameters

slugstring
required·

Connector slug.

Response Body

client_idstring,null
has_client_secretboolean

Whether a secret is stored. The secret itself is never returned.

oauth_app_modestring

Which application connects on this connector use.

Possible values:
platform_defaultbyoa
optional_scopearray,null
scopearray,null

Scope overrides this org stored, or null when it kept the catalog scopes.

updated_atstring,null
user_scopestring,null

Space-separated authorize-URL scopes (params.user_scope), or null.

curl -X GET 'https://api.elaichi.ai/connector/<slug>/oauth-app' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
const response = await fetch('https://api.elaichi.ai/connector/<slug>/oauth-app', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import os
import requests

url = "https://api.elaichi.ai/connector/<slug>/oauth-app"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())