Start organization OAuth flow

curl --request GET \
  --url https://api.onecli.sh/v1/org/apps/{provider}/authorize \
  --header 'Authorization: Bearer <token>'

{
  "error": "<string>"
}

Organization App Config

Start organization OAuth flow

Starts an OAuth flow that creates the connection at the organization level, shared by every project in the organization. Redirects to the app’s OAuth authorization page; the flow completes on the shared /apps/{provider}/callback endpoint, so no extra redirect URI registration is needed.

Typically opened in a browser. With an organization API key the target organization is derived from the key. Available on OneCLI Cloud and self-hosted Enterprise. Requires the admin or owner role.

GET

org

apps

{provider}

authorize

Start organization OAuth flow

curl --request GET \
  --url https://api.onecli.sh/v1/org/apps/{provider}/authorize \
  --header 'Authorization: Bearer <token>'

{
  "error": "<string>"
}

Authorizations

Authorization

string

header

required

API key obtained from the dashboard or GET /user/api-key

Path Parameters

provider

string

required

App provider identifier (e.g., gmail, github, jira)

Query Parameters

connectionId

string

Reconnect an existing organization connection instead of creating a new one

org

string

Target organization ID when the caller belongs to several organizations. Defaults to the organization derived from the credentials.

Response

Redirect to OAuth provider

Disconnect an organization connection Connect app at the organization level