Read the owner's personal ChatGPT connection.

GET

/v1/providers/{provider_id}/chatgpt

const url = 'https://app.everruns.com/api/v1/providers/example/chatgpt';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.everruns.com/api/v1/providers/example/chatgpt

Returns connection state and non-secret installation metadata. Another user’s provider is hidden even from organization administrators.

Parameters

Path Parameters

provider_id

required

string

Personal provider ID

Responses

200

Personal connection status

application/json

Personal ChatGPT connection state, without access or refresh credentials.

object

email

Verified account email, present after a successful sign-in.

string | null

error

Safe connection error or reconnect guidance, when applicable.

string | null

host_id

required

Installation identifier to pass unchanged to the local login helper.

string

owner_user_id

Everruns user who owns and may manage this personal connection.

string | null

registration

Non-secret host registration, containing the issuing client and verified subject.

object | null

status

required

Connection state: disconnected, connecting, connected, scope_required, or error.

string

Example

{
  "email": "[email protected]",
  "error": "ChatGPT sign-in did not complete. Retry sign-in.",
  "host_id": "urn:uuid:00000000-0000-0000-0000-000000000001",
  "owner_user_id": "00000000-0000-0000-0000-000000000001",
  "status": "disconnected"
}

400

Invalid connection request

404

Provider not found or owned by another user

502

Provider exchange or revocation failed