/api/orgs/{org_id}/provider-connections/{provider}/plans/sign-in/completeComplete a plan sign-in
Redeems the returned code and stores the plan in the scope chosen at start. The state is spent whether or not the exchange succeeds (409 when unknown, expired or reused; start again). A pool sign-in is finished by its starter, an org admin, or the org's key; an account-scoped one only by the member who started it (403 plan_sign_in_not_yours).
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
statestringrequiredcallbackstringrequiredThe pasted landing address,
code#state, or the bare code.setup_aliasstring | nullThe handle, when it was not given at start.
scopeenumOptional; must equal the scope chosen at start.
Responses
200The stored plan account.
Response
setup_aliasstringrequiredplanobjectrequiredWhat a plan account carries instead of a key.
plan
labelstringrequiredplan_typestring | nullrequiredFor example plus, pro, team, max.
primaryobject | nullrequiredOne of
object
used_percentintegerrequiredreset_atstring | nullrequiredwindow_minutesinteger | nullrequired
secondaryobject | nullrequiredOne of
object
used_percentintegerrequiredreset_atstring | nullrequiredwindow_minutesinteger | nullrequired
derivedobject | nullOne of
object
five_hourobject | nullrequiredOne of
object
requestsintegerrequiredinput_tokensintegerrequiredcached_input_tokensintegerrequiredoutput_tokensintegerrequiredfirst_activitystring | nullrequiredlast_activitystring | nullrequired
seven_dayobject | nullrequiredOne of
object
requestsintegerrequiredinput_tokensintegerrequiredcached_input_tokensintegerrequiredoutput_tokensintegerrequiredfirst_activitystring | nullrequiredlast_activitystring | nullrequired
checked_atstring | nullrequiredscopeenumorg: the shared pool;account: only API keys created byowner_user_id.owner_user_idstring | nullrotation_pausedbooleanA paused plan never serves.
refreshes_atstring | nullWhen a plan paused for a spent window refreshes.
statusenumrequiredThe provider-verified key state, written by the hookup check and by real traffic.
provider_errormeans the provider was unreachable when checked, not that the key is bad.scopeenumrequiredowner_user_idstring | nullrequiredrotation_pausedbooleanrequired
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).
403Only the member who started an account-scoped sign-in may finish it.
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).
404The resource does not exist or belongs to another organization.
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).
409The state is unknown, expired, already used, or the handle belongs to a plan in another scope (
plan_scope_conflict).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).
422The provider refused the code, the handle is invalid, or
scopedisagrees with the start (plan_scope_mismatch).
Request
curl -X POST https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/plans/sign-in/complete \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"state": "Yk3vR8pQ2wNfT6hJmZ1cXa",
"callback": "http://localhost:1455/auth/callback?code=ac_EXAMPLE7d2f&scope=openid&state=Yk3vR8pQ2wNfT6hJmZ1cXa",
"setup_alias": "chatgpt-team"
}'Response
{
"setup_alias": "chatgpt-team",
"plan": {
"label": "dev@acme.example",
"plan_type": "team",
"primary": {
"used_percent": 12,
"reset_at": "2026-11-19T18:40:00Z",
"window_minutes": 300
},
"secondary": {
"used_percent": 41,
"reset_at": "2026-11-23T09:00:00Z",
"window_minutes": 10080
},
"derived": null,
"checked_at": "2026-11-19T14:21:07.330Z",
"scope": "org",
"owner_user_id": null,
"rotation_paused": false,
"refreshes_at": null
},
"status": "valid",
"scope": "org",
"owner_user_id": null,
"rotation_paused": false
}https://api.experientiallabs.ai/api/orgs/3f6c2a1e-8b7d-4c2a-9e51-6a0d4b2f7c10/provider-connections/openai/plans/sign-in/complete