/api/orgs/{org_id}/provider-connections/{provider}/plans/sign-inStart a plan sign-in
Mints a one-time PKCE sign-in (valid 15 minutes) and returns the authorization URL to open. With completion: paste the operator pastes the address the browser lands on (ChatGPT) or the returned code into sign-in/complete; with redirect the web callback completes it. Adding a plan needs Pro with no grandfather clause (402 pro_required); re-signing in a handle the org already holds does not. Claude plans require setup_alias. An API key cannot use scope: account (422 account_scope_needs_member).
Authentication: Bearer API key in the Authorization header
Path parameters
org_idstringrequiredYour organization id (uuid).
GET /api/whoamireturns it.providerenumrequiredopenaifor ChatGPT plans,anthropicfor Claude plans. Any other provider answers 404.
Request body
setup_aliasstring | nullThe new account's handle (a slug, not the bare provider name). Required for Claude plans.
scopeenumaccount(only your own keys draw on it) needs a signed-in member, not an API key.
Responses
200The sign-in to open.
Response
statestringrequiredauthorize_urlstringrequiredcallback_urlstringrequiredcompletionenumrequiredexpires_atstringrequired
401Missing, unknown or revoked API key.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
402Adding a plan account needs Pro.
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
403The key is valid but may not perform this action (for example an inference key on a provisioning-key route, or a feature outside your plan).
Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
404Not a member, or Claude plans are not enabled on this deployment (
claude_plans_unavailable).Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
422Missing or bare-provider handle, or
scope: accountfrom an API key (account_scope_needs_member).Response
errorstringrequiredHuman-readable message.
codestringStable machine reason, when the route defines one (for example
pro_required).actionstringStable remediation action, when the route defines one.
detailsobjectCustomer-safe string facts the caller needs to act (for example a suggested identifier).
Request
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/plans/sign-in \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"setup_alias": "chatgpt-team",
"scope": "org"
}'Response
{
"state": "Yk3vR8pQ2wNfT6hJmZ1cXa",
"authorize_url": "https://auth.openai.com/oauth/authorize?response_type=code&client_id=app_EXAMPLE&redirect_uri=http%3A%2F%2Flocalhost%3A1455%2Fauth%2Fcallback&code_challenge=EXAMPLE&code_challenge_method=S256&state=Yk3vR8pQ2wNfT6hJmZ1cXa",
"callback_url": "http://localhost:1455/auth/callback",
"completion": "paste",
"expires_at": "2026-11-19T14:35:00.000000+00:00"
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/plans/sign-in