---
title: "Who this key acts as"
method: GET
path: "/cli/session"
tags: ["CliLogin"]
---

# Who this key acts as

`GET /cli/session`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/cli/session`
- Auth: HTTP bearer

The workspace the key belongs to, the key itself, and — for a key made
by a CLI sign-in — the person who approved it. Needs a full-scope key.

## Response `200`

The key's workspace and person

- CliSession
  - `workspace` object, required
    - `id` string, required
    - `name` string, required
  - `user` object, nullable, required: The person who approved the CLI sign-in. Null for a key made in Settings.
    - `id` string
    - `email` string
  - `key` object, nullable, required
    - `id` string
    - `name` string
    - `prefix` string
    - `scope` 'full' | 'sending'
    - `fromLogin` boolean: Made by a CLI sign-in (so `DELETE /cli/session` revokes it).

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)