Models and accounts

Cursor accounts

Connecting a Cursor subscription, and the accounts already connected

On this page(5 sections)

Begin connecting a Cursor account
Abandon a Cursor sign-in
Connected Cursor accounts
Rename a Cursor account
Disconnect a Cursor account

Begin a sign-in, abandon one nobody finished, see what is connected, rename one, disconnect one. A sandbox can hold several side by side. Nothing is pasted back and there is no code to type: the page that opens is already addressed to the attempt, and the sandbox completes the exchange itself, so the way to learn it worked is to watch the account list.

POST/cursor/login/startBegin connecting a Cursor account

Hands back the page to sign in on. The sandbox finishes the handshake itself and stores the credential, so nothing has to be pasted back: watch the account list instead.

What you send

Nothing. Call it as it is.

What comes back

Field	Type
`url`The page to open and sign…	string
`handshake`This attempt's id, for abandoning it	string
`expiresAt`When this attempt stops being answerable,…	number

Try itanswered in this tab

curl

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

TypeScript

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

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

POST/cursor/login/cancelAbandon a Cursor sign-in

Stops waiting on a sign-in nobody completed. An abandoned attempt also expires on its own.

What you send

Field	Type	Where
`handshake`requiredWhich attempt to stop waiting on	string	body

What comes back

Field	Type
`ok`Always true	true

Try itanswered in this tab

curl

curl -X POST "$SANDBOX/cursor/login/cancel" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"handshake":"…"}'

TypeScript

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

const result = await sandbox.cursor.cancel({
  "handshake": "…"
});

GET/cursor/accountsConnected Cursor accounts

Each connected account, and whether its stored key is still good. Cursor publishes no plan-wide allowance, so these rows carry no usage reading.

What you send

Field	Type	Where
`force`Measure the plan limits again before…	string	query

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/cursor/accounts" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

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

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

POST/cursor/account/renameRename a Cursor account

Changes the label one account shows under, so several are tellable apart.

What you send

Field	Type	Where
`id`requiredWhich account	string	body
`label`requiredThe new name	string	body

What comes back

Field	Type
`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 -X POST "$SANDBOX/cursor/account/rename" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"id":"a1b2c3d4","label":"Nightly changelog"}'

TypeScript

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

const result = await sandbox.cursor.rename({
  "id": "a1b2c3d4",
  "label": "Nightly changelog"
});

POST/cursor/account/disconnectDisconnect a Cursor account

Clears the stored key for one account. The others stay connected.

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/cursor/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.cursor.disconnect({
  "id": "a1b2c3d4"
});