Models and accounts

Grok accounts

Connecting an xAI subscription, and the account already connected

On this page(3 sections)

Begin connecting a Grok account
Connected Grok account
Disconnect the Grok account

Begin a sign-in with a code typed on another page, see what is connected, disconnect it. The sandbox waits for the sign-in to complete on its own, so nothing is pasted back.

POST/grok/oauth/startBegin connecting a Grok account

Hands back the page to open and the one-time code to type there. Nothing is pasted back afterwards: the sandbox waits for the sign-in to complete on its own, so poll the accounts call until it appears.

What you send

Nothing. Call it as it is.

What comes back

Field	Type
`url`The page to open, which already…	string
`code`The one-time code, shown as well…	string

Try itanswered in this tab

curl

curl -X POST "$SANDBOX/grok/oauth/start" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.grok.start();

GET/grok/accountsConnected Grok account

What is signed in. A list for consistency with the other providers, though there is at most one.

What you send

Nothing. Call it as it is.

What comes back

Field	Type
`accounts`The connected accounts	object[]
`id`The account's id, which is what…	string
`label`What it is called here, which…	string
`email`Who it signs in as, in…	string
`organization`Which organisation it belongs to, where…	string
`scope`What the credential is permitted to…	string
`connectedAt`When it was connected, in milliseconds	number
`needsReauth`Its stored credential can no longer…	boolean
`detail`Why, in words a person can…	string
`usage`How full its plan limits were…	object
`windows`	object[]
`kind`	string
`label`	string
`utilization`	number
`resetsAt`	number
`measuredAt`	number

Try itanswered in this tab

curl

curl "$SANDBOX/grok/accounts" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.grok.accounts();

POST/grok/account/disconnectDisconnect the Grok account

Clears the stored tokens.

What you send

Field	Type	Where
`id`requiredWhich account	string	body

What comes back

Field	Type
`ok`Always true	true

Try itanswered in this tab

curl

curl -X POST "$SANDBOX/grok/account/disconnect" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"id":"a1b2c3d4"}'

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.grok.disconnect({
  "id": "a1b2c3d4"
});