> Kenso API docs in Markdown. Index of every page: [/docs/llms.txt](/docs/llms.txt). Search: `/docs/search.md?q=<words>`. OpenAPI: [/docs/api/me/openapi.json](/docs/api/me/openapi.json). CLI docs offline: `kenso docs <topic>`.
> Last updated: 2026-11-22.

# Your account

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

The caller your API key or token acts as.

Workspace and account. 1 endpoint under `https://api.ken.so`. Every request sends `Authorization: Bearer <your API key>` and `Ken-Version: 2026-11-02`: see [Authentication](/docs/authentication.md), [Workspaces](/docs/workspaces.md) and [Errors](/docs/errors.md). OpenAPI for this resource only: [/docs/api/me/openapi.json](/docs/api/me/openapi.json).

- `GET /v1/me` - Get the signed-in caller (`me.get`): [/docs/api/me/get.md](/docs/api/me/get.md)

## Get the signed-in caller

`GET /v1/me` - operationId `me.get`

| Permission | Rate limit |
| --- | --- |
| Any signed-in caller | 12,000 requests a minute per API key |

Returns the caller's profile and social links, the workspaces they belong to (each with `socialPosts`:
whether the caller's own social posts feed it, and why), and the features, permissions and plan of the current
workspace.

The current workspace is the one in `X-Ken-Workspace-Id`, when the caller belongs to it. Without the
header it is the caller's only workspace, and a caller in several workspaces has none. `features`,
`permissions` and `hasPaidPlan` all describe that workspace. `role` is deprecated.

Errors:

- `403 forbidden`: the caller's account is inactive or belongs to no workspace, or the caller is a workspace
key, which is not a person and has no profile. A workspace key reads its workspace with `GET /v1/workspaces`.

Open to any signed-in caller.

[Try it on developer.ken.so](https://developer.ken.so/reference/#kenso-api/tag/me/GET/v1/me)

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Ken-Version` | header | string, one of: 2026-11-02, 1.1 | no | The API version, a date in `YYYY-MM-DD` form. `1.1` is another name for the first dated version. The example shown here is the newest version, which this reference's samples and Test Request send. Leave it out to use your API key's pinned version. Keys created in the Kenso app are pinned to the newest version; keys minted by the CLI login are not. A key with no pinned version and no header gets the legacy shape where the path has one, and `404` where the path exists only in this version. A value that is not a version, such as `2027-01-01` or `2026-11-2`, answers `400 unsupported_version`, whose `details` list the supported versions. |

### Response 200

`data` is a `Me`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | integer (int64) | The caller's Kenso user id. |
| `email` | string | The email address the caller signs in with. |
| `emailVerified` | boolean | Whether Kenso treats the caller's email as verified: they confirmed it from the verification email, or they sign in with Google, LinkedIn or Microsoft. Can turn true up to about a minute after the link is opened. Omitted when Kenso has no record either way. |
| `firstName` | string | The caller's first name. Omitted when unset. |
| `lastName` | string | The caller's last name. Omitted when unset. |
| `role` | string | Deprecated. The caller's role in the current workspace: `admin`, `member`, `view_only` or `client`. |
| `isSuperAdmin` | boolean | True for a Kenso team account. |
| `isActive` | boolean | Whether the caller's account is active. |
| `linkedinUrl` | string | The caller's LinkedIn profile URL. Omitted when unset. |
| `instagramUrl` | string | The caller's Instagram profile URL, in Kenso's canonical form. Omitted when unset. |
| `xUrl` | string | The caller's X profile URL (`https://x.com/handle`). Omitted when unset. |
| `youtubeUrl` | string | The caller's YouTube channel URL, in Kenso's canonical form. Omitted when unset. |
| `githubUrl` | string | The caller's GitHub profile URL (`https://github.com/owner`). Omitted when unset. |
| `jobTitle` | string | The caller's job title. Omitted when unset. |
| `timeZone` | string | The caller's IANA time zone id, such as `America/New_York`. Omitted when unset. |
| `language` | string | The caller's language, a BCP 47 tag such as `fr` or `fr-FR`. Omitted when unset, which means English. |
| `profileImageUrl` | string | The URL of the caller's profile photo. Omitted when there is none. |
| `createdAt` | string (date-time) | When the account was created, in UTC. |
| `updatedAt` | string (date-time) | When the profile last changed, in UTC. |
| `deletionDueAt` | string (date-time) | When the account is due to be deleted, in UTC. Omitted unless a deletion is pending. |
| `workspaces` | array of MeWorkspace | The workspaces the caller belongs to. |
| `features` | array of string | The keys of the features on for the caller in the current workspace, sorted, such as `["accounts", "studio"]`. Always present, and empty when none is on. |
| `permissions` | MePermissions | What the caller can do in the current workspace. For an API key held to a permission template, that template narrows them further. Always present, and null when there is no current workspace, the workspace does not have the `permissions` feature, or Kenso cannot read them. |
| `hasPaidPlan` | boolean | Whether the current workspace is on a paid plan: an active or trialing plan other than Free. A white-label client workspace reads the plan of the workspace that manages it. Always present, and null when there is no current workspace or Kenso cannot read the plan. |

### Request

```bash
curl -X GET "https://api.ken.so/v1/me" \
  -H "Authorization: Bearer $KENSO_API_KEY" \
  -H "Ken-Version: 2026-11-02"
```

### Example response

```json
{
  "success": true,
  "data": {
    "id": 812,
    "email": "jane@example.com",
    "emailVerified": true,
    "firstName": "Jane",
    "lastName": "Doe",
    "role": "admin",
    "isSuperAdmin": true,
    "isActive": true,
    "linkedinUrl": "https://example.com",
    "instagramUrl": "https://example.com",
    "xUrl": "https://example.com",
    "youtubeUrl": "https://example.com",
    "githubUrl": "https://example.com",
    "jobTitle": "string",
    "timeZone": "America/New_York",
    "language": "fr",
    "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": "admin",
        "logoUrl": "https://example.com",
        "wordmarkUrl": "https://example.com",
        "wordmarkDarkUrl": "https://example.com",
        "parentWorkspaceId": 812,
        "socialPosts": {
          "mode": "string",
          "on": true,
          "reason": "string"
        }
      }
    ],
    "features": [
      "string"
    ],
    "permissions": {
      "workspaceId": 812,
      "template": {
        "id": 812,
        "name": "string",
        "builtIn": "admin"
      },
      "pages": {
        "key": "string"
      },
      "features": [
        "billing"
      ],
      "accountScope": "string",
      "monthlyCreditLimit": 1,
      "creditsUsedThisMonth": 1
    },
    "hasPaidPlan": true
  }
}
```

## Types

Each named type the tables above use, nested ones included.

### MeWorkspace

A workspace the caller belongs to.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer (int64) | no | The workspace id. |
| `name` | string | no | The workspace's name. |
| `role` | string | no | The caller's role in the workspace: `admin`, `member`, `view_only` or `client`. |
| `logoUrl` | string | no | The URL of the workspace's square icon. Omitted when none is set. |
| `wordmarkUrl` | string | no | The URL of the workspace's wide logo. Omitted when none is set. |
| `wordmarkDarkUrl` | string | no | The URL of the workspace's wide logo for dark backgrounds, usually a white version of the wide logo. Booking pages in dark mode show it in place of the wide logo. Null when none is set. |
| `parentWorkspaceId` | integer (int64) | no | For a white-label client workspace, the workspace that manages it. Omitted otherwise. |
| `socialPosts` | MeSocialPosts | no | Whether the caller's own social posts feed this workspace, and why. Omitted when it could not be read. |

### MePermissions

What the caller can do in one workspace.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `workspaceId` | integer (int64) | no | The workspace these permissions apply to. |
| `template` | MePermissionTemplate | no | The permission template the caller's seat uses. |
| `pages` | map of string | no | Each of the eleven pages of the Kenso app, keyed by page name, set to `off`, `view` or `edit`. |
| `features` | array of string | no | The permissions the caller has beyond page access, such as `billing` or `members`. |
| `accountScope` | string | no | Which accounts the caller sees on the Accounts page: `all` for every account, or `own` for only the accounts they own. |
| `monthlyCreditLimit` | integer (int64) | no | The credits the caller may spend in this workspace each calendar month, in UTC. Null means no limit, and 0 means the caller cannot spend credits. |
| `creditsUsedThisMonth` | integer (int64) | no | The whole credits the caller spent in this workspace this calendar month, in UTC. |

### MeSocialPosts

Whether a person's own social posts feed one workspace.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `mode` | string | no | The person's choice: `auto` (Kenso decides), `on` or `off`. |
| `on` | boolean | no | Whether their posts feed the workspace now. |
| `reason` | string | no | Why: `client_seat` (a Client seat's posts never feed a workspace), `kenso_staff` (a Kenso staff member's posts feed Kenso's own workspace and no other), `chosen_on`, `chosen_off`, `email_domain_match` (their email domain is the workspace website's), `only_workspace` (their only workspace) or `no_match`. |

### MePermissionTemplate

The permission template a seat uses.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | integer (int64) | no | The template id. Null for a built-in template the workspace has never edited. |
| `name` | string | no | The template's name. |
| `builtIn` | string | no | Which built-in template this is: `admin`, `editor`, `viewer` or `client`. Null for a template the workspace made. |

All resources: [/docs.md](/docs.md).
