---
title: "Introspect the calling key: workspace, environment, scopes, and the plan capabilities that gate the paid REST/Zapier surface (so an agent can discover entitlements without triggering a 402)."
method: GET
path: "/me"
---

# Introspect the calling key: workspace, environment, scopes, and the plan capabilities that gate the paid REST/Zapier surface (so an agent can discover entitlements without triggering a 402).

`GET /me`

## Request

- Base URL: `https://app.seomatic.ai/api/v1`
- URL: `https://app.seomatic.ai/api/v1/me`
- Auth: HTTP bearer

## Headers

- `X-Seomatic-Client` 'n8n' | 'make'

## Response `200`

Key and workspace details

- object
  - `workspace` object
    - `id` string
    - `name` string
    - `gsc_connected` boolean
  - `key` object
    - `environment` 'live' | 'test'
    - `scopes` string[]
  - `capabilities` object: Plan-gated surface permissions (reads/chat work on any plan).
    - `rest_act` boolean: agents:act over REST (Infrastructure).
    - `zapier` boolean: Zapier, Make and n8n reads and triggers (any paid plan or trial).
    - `webhooks` boolean: Outbound webhooks (Infrastructure).
  - `free_questions` object, nullable: Free-plan question meter that tool calls spend (the pool is shared with chat and MCP). null on paid plans, where tool calls are not metered.
    - `monthly_limit` integer
    - `used_this_month` integer
    - `bonus_remaining` integer: Purchased or earned questions, spent after the monthly allowance.
    - `remaining` integer: Tool calls still available right now.

## Other responses

- `401`: Missing or invalid API key
- `402`: X-Seomatic-Client is n8n or make and the workspace has no paid plan or trial (AUTOMATION_NOT_ENTITLED). Body carries upgrade_url.
- `429`: Rate limited (per key). Retry-After header set.

---

[API](https://skmtc.dev/seomatic/apis/seomatic-api.md) · [All operations](https://skmtc.dev/seomatic/apis/seomatic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seomatic/apis/seomatic-api/revisions/113a2a263604?raw)