---
title: "Retrieves the current account for the token accessing the API"
method: GET
path: "/v1/account"
tags: ["AccountService", "Accounts"]
---

# Retrieves the current account for the token accessing the API

`GET /v1/account`

Retrieves the current account for the token accessing the API. Useful to check if the credentials are valid.

## Response `200`

OK

- Account — An account, the top-level organizational unit. Contains workspaces and account-wide settings such as the webhook signing secret.
  - `metadata` AccountResourceMetadata, required — AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.
    - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")
    - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID)
    - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly
    - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system)
    - `labels` object — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. Examples: {"environment": "production", "team": "platform", "version": "v2"}
    - `profileId` string, required
    - `createdAt` string, date-time
  - `spec` AccountSpec, required — Configuration for an account.
    - `description` string
    - `domain` string
    - `billingEmail` string
    - `workspaces` Workspace[]
      - `metadata` AccountResourceMetadata, required — AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.
        - `id` string, required — Unique identifier for the resource (prefixed ULID, e.g., "apikey_01HXK...")
        - `accountId` string, required — Account this resource belongs to for multi-tenant isolation (prefixed ULID)
        - `name` string, required — Human-readable name for the resource (e.g., "Customer Support Agent", "Email Tool") Required for resources that users interact with directly
        - `externalId` string — External ID for the resource (e.g., a workflow ID from an external system)
        - `labels` object — Key-value pairs for categorization and filtering. Values are 0-63 alphanumeric characters with "-", "_", or "." allowed between; keys follow the same shape and additionally accept an optional DNS-subdomain prefix (e.g. "cadenya.com/") of at most 253 characters. Examples: {"environment": "production", "team": "platform", "version": "v2"}
        - `profileId` string, required
        - `createdAt` string, date-time
      - `spec` WorkspaceSpec, required
        - `description` string
      - `status` 'STATUS_ENABLED' | 'STATUS_DISABLED' | 'STATUS_ARCHIVED', enum — Lifecycle status of the workspace. Archived workspaces reject all requests scoped to them. Server-populated.
      - `info` WorkspaceInfo — WorkspaceInfo returns counts
        - `totalAvailableTools` integer
        - `totalMemoryEntries` integer
        - `totalAgents` integer
        - `totalAgentVariations` integer
  - `info` AccountInfo, required — Server-populated information about the account.
    - `webhookEventsHmacSecret` string — The generated secret that will sign all webhooks that are sent to your configured Webhook URL. Formatted as "wh_asdf1234" per the https://www.standardwebhooks.com/ format.
    - `challengeToken` string — The challenge token Cadenya sends in the X-Cadenya-Challenge-Token header on every MCP tools/list request. Server implementations can accept a valid challenge token in place of per-user auth when listing tools, while still requiring real auth on tools/call. Rotate with RotateChallengeToken; update any servers validating the token before rotating.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/cadenya/apis/cadenya-api.md) · [All operations](https://skmtc.net/cadenya/apis/cadenya-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cadenya/cadenya-api/versions/ac1a7f084068/schema)