Kenso

Me

The caller your API key or token acts as.

Workspace and credits1 endpointKen-Version: 2026-11-02AuthenticationWorkspacesErrors

Replaces GET /v1/me/context, GET /v1/users/me, and GET /v1/workspaces/me. Read-only. Requires ReadAccess. When X-Ken-Workspace-Id is present, role is the caller's role in that workspace. A super admin's role stays super_admin. features is always present: the sorted feature flag keys on for the caller, e.g. ["accounts", "app_v4"]. The workspace is X-Ken-Workspace-Id when the caller may act in it, else the caller's only workspace, else none. Gate UI on it; never on flag rows. permissions is always present: the caller's effective permissions in that same workspace (template, pages, features, account scope, monthly credit limit, credits used this month), narrowed by an API key's template. It is null for a super admin, when there is no workspace, while the permissions feature flag is off for the workspace (the default), or when permissions could not be evaluated (including an API key that no longer resolves). hasPaidPlan is always present: whether that same workspace is on a paid plan, null for a super admin, when there is no workspace, or when the plan could not be read. role is deprecated.

Parameters

Name
In
Type
Required
Description
Ken-Version
In: header
string, one of: 2026-11-02, 1.1
required
The API version: a dated version (YYYY-MM-DD), or 1.1, another name for the first dated version. Without it the request uses your API key's pinned version; an unpinned key reaches the legacy shape of the same path. 1.0 selects the legacy shape explicitly.

Response 200

data is a MeModel.

Field
Type
Description
id
integer (int64)
email
string
firstName
string
lastName
string
role
string
admin, member, view_only, client, or super_admin.
isSuperAdmin
boolean
isActive
boolean
linkedinUrl
string
jobTitle
string
The caller's job title. Omitted when unset.
timeZone
string
IANA time zone id, for example America/New_York. Omitted when unset. The member's app time zone: Today, calls, nav counts and, after the daily brief's own zone, notifications use it.
language
string
The caller's language, a BCP 47 tag such as fr or fr-FR. Omitted when unset; null means en.
profileImageUrl
string
createdAt
string (date-time)
updatedAt
string (date-time)
deletionDueAt
string (date-time)
workspaces
array of MeWorkspaceModel
features
array of string
Feature flag keys that are on for the caller in the workspace from X-Ken-Workspace-Id (or the caller's only workspace), sorted ascending. Always present; empty when nothing is on.
permissions
MePermissionsModel
Effective permissions in one workspace. Pages and features use catalog order and wire names.
hasPaidPlan
boolean
Whether the workspace Ken.Scraper.API.Canonical.MeModel.Features uses is on a paid plan: an Active or Trialing plan other than Free (a white-label child reads its master's). Always present; null for staff, when there is no workspace, or when the plan could not be read.
Request
curl -X GET "https://api.ken.so/v1/me" \
  -H "Authorization: Bearer $KEN_API_KEY" \
  -H "Ken-Version: 2026-11-02"
Response 200
{
  "success": true,
  "data": {
    "id": 812,
    "email": "[email protected]",
    "firstName": "string",
    "lastName": "string",
    "role": "string",
    "isSuperAdmin": true,
    "isActive": true,
    "linkedinUrl": "https://example.com",
    "jobTitle": "string",
    "timeZone": "string",
    "language": "string",
    "profileImageUrl": "https://example.com",
    "createdAt": "2026-09-23T15:02:11Z",
    "updatedAt": "2026-09-23T15:02:11Z",
    "deletionDueAt": "2026-09-23T15:02:11Z",
    "workspaces": [
      {
        "id": 812,
        "name": "string",
        "role": "string",
        "logoUrl": "https://example.com",
        "wordmarkUrl": "https://example.com",
        "parentWorkspaceId": 812
      }
    ],
    "features": [
      "string"
    ],
    "permissions": {
      "workspaceId": 812,
      "template": {
        "id": 812,
        "name": "string",
        "builtIn": "string"
      },
      "pages": {
        "key": "string"
      },
      "features": [
        "string"
      ],
      "accountScope": "string",
      "monthlyCreditLimit": 1,
      "creditsUsedThisMonth": 1
    },
    "hasPaidPlan": true
  }
}