Authorize a user

1
import os
2

3
from dotenv import load_dotenv
4
from scalekit import ScalekitClient
5
from scalekit.common.exceptions import ScalekitServerException
6

7
load_dotenv()
8

9
scalekit_client = ScalekitClient(
10
    env_url=os.environ["SCALEKIT_ENVIRONMENT_URL"],
11
    client_id=os.environ["SCALEKIT_CLIENT_ID"],
12
    client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
13
)
14
actions = scalekit_client.actions
15

16
try:
17
    # Create or retrieve the connected account for this user
18
    response = actions.get_or_create_connected_account(
19
        connection_name="github-connect",
20
        identifier="user_123"  # your app's unique user ID
21
    )
22
    connected_account = response.connected_account
23

24
    # Generate the authorization link if the account is not yet active
25
    if connected_account.status != "ACTIVE":
26
        link_response = actions.get_authorization_link(
27
            connection_name="github-connect",
28
            identifier="user_123"
29
        )
30
        auth_url = link_response.link
31
        # Redirect or send auth_url to the user
32
except ScalekitServerException as e:
33
    # For example, the connection name doesn't match the dashboard
34
    print("Scalekit error:", e.error_code, e.message)

1
import 'dotenv/config';
2
import { ConnectorStatus, ScalekitClient, ScalekitServerException } from '@scalekit-sdk/node';
3

4
const scalekit = new ScalekitClient(
5
  process.env.SCALEKIT_ENVIRONMENT_URL!,
6
  process.env.SCALEKIT_CLIENT_ID!,
7
  process.env.SCALEKIT_CLIENT_SECRET!,
8
);
9
const actions = scalekit.actions;
10

11
try {
12
  // Create or retrieve the connected account for this user
13
  const response = await actions.getOrCreateConnectedAccount({
14
    connectionName: 'github-connect',
15
    identifier: 'user_123',  // your app's unique user ID
16
  });
17

18
  const connectedAccount = response.connectedAccount;
19

20
  // Generate the authorization link if the account is not yet active
21
  if (connectedAccount?.status !== ConnectorStatus.ACTIVE) {
22
    const linkResponse = await actions.getAuthorizationLink({
23
      connectionName: 'github-connect',
24
      identifier: 'user_123',
25
    });
26
    const authUrl = linkResponse.link;
27
    // Redirect or send authUrl to the user
28
  }
29
} catch (err) {
30
  if (!(err instanceof ScalekitServerException)) throw err;
31
  // For example, the connection name doesn't match the dashboard
32
  console.error('Scalekit error:', err.errorCode, err.message);
33
}

1
response = actions.get_or_create_connected_account(
2
    connection_name="github-connect",
3
    identifier="user_123"
4
)
5
connected_account = response.connected_account
6
# ACTIVE: ready for tool calls
7
# PENDING_AUTH: the user hasn't completed authorization yet
8
# PENDING_VERIFICATION: authorized, but user verification is still pending
9
# EXPIRED: tokens expired or were revoked; the user must authorize again
10
# DISCONNECTED: the account was disconnected
11

12
if connected_account.status != "ACTIVE":
13
    link_response = actions.get_authorization_link(
14
        connection_name="github-connect",
15
        identifier="user_123"
16
    )
17
    # Redirect or send link_response.link to the user

1
import { ConnectorStatus } from '@scalekit-sdk/node';
2

3
const response = await actions.getOrCreateConnectedAccount({
4
  connectionName: 'github-connect',
5
  identifier: 'user_123',
6
});
7

8
const connectedAccount = response.connectedAccount;
9
// ACTIVE: ready for tool calls
10
// PENDING_AUTH: the user hasn't completed authorization yet
11
// PENDING_VERIFICATION: authorized, but user verification is still pending
12
// EXPIRED: tokens expired or were revoked; the user must authorize again
13
// DISCONNECTED: the account was disconnected
14

15
if (connectedAccount?.status !== ConnectorStatus.ACTIVE) {
16
  const linkResponse = await actions.getAuthorizationLink({
17
    connectionName: 'github-connect',
18
    identifier: 'user_123',
19
  });
20
  // Redirect or send linkResponse.link to the user
21
}