Start OAuth flow

Redirects the user to the app’s OAuth authorization page. After the user authorizes, they are redirected back to the callback URL.

This endpoint is typically opened in a browser, not called from code.

GET /apps/{provider}/authorize

Start OAuth flow

cURL

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

400

{
  "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 connection instead of creating a new one

agent_name · string

Agent name to associate with the connection

Response

302

Redirect to OAuth provider