Developer CLI

Who the CLI token acts for

GET/v1/cli/whoami

The person, the workspace (with its books currency), the token’s scopes and expiry, and whether this person may add agents.

#Authentication

CLI token

A token (imc_...) the developer CLI gets by signing in through the browser (immiscible login, the OAuth device grant), sent as Authorization: Bearer. It acts for one person in one workspace: it reads agents and status, and registers an agent with a rule from the same purposes as the console's "Add an agent". It never approves anything or changes an existing rule. Every use re-checks the person's membership and the workspace's sign-in rules; it lasts 90 days and ends from the console's sessions.

Request

curl "https://immiscible.fly.dev/v1/cli/whoami" \
  -H "authorization: Bearer $IMMISCIBLE_TOKEN"

const res = await fetch('https://immiscible.fly.dev/v1/cli/whoami', {
  headers: {
    authorization: `Bearer ${process.env.IMMISCIBLE_TOKEN}`,
  },
});
const data = await res.json();
console.log(res.status, data);

import os
import requests

res = requests.get(
    "https://immiscible.fly.dev/v1/cli/whoami",
    headers={
        "authorization": f"Bearer {os.environ['IMMISCIBLE_TOKEN']}",
    },
)
print(res.status_code, res.json())

Response

JSON

{
  "user": {
    "id": "usr_d253e4892f3a4c5d",
    "email": "jules@amethyst.example",
    "name": "Jules Moreau"
  },
  "workspace": {
    "id": "ws_12832a06f3134d5f",
    "name": "Amethyst",
    "role": "owner",
    "currency": "GBP"
  },
  "token": {
    "id": "clt_b11e4ffb3aeb0179",
    "name": "docs",
    "scopes": [
      "agents:read"
    ],
    "createdAt": "2026-10-06T12:47:41.518Z",
    "expiresAt": "2027-01-04T12:47:41.518Z"
  },
  "can": {
    "addAgents": true
  },
  "server": {
    "url": "https://immiscible.fly.dev",
    "version": "1.0.0",
    "time": "2026-10-06T12:47:47.522Z"
  }
}