---
title: "Describe the authenticated API identity. Canonical identity is workspace_id + agent_id; effective authority is the scopes of the credential actually presented (credential.credential_id). One Agent Identity may hold several credentials with different scopes ([read] or [read,write]) and independent expiry/revocation. Never returns keys or credentials."
method: GET
path: "/me"
---

# Describe the authenticated API identity. Canonical identity is workspace_id + agent_id; effective authority is the scopes of the credential actually presented (credential.credential_id). One Agent Identity may hold several credentials with different scopes (\[read\] or \[read,write\]) and independent expiry/revocation. Never returns keys or credentials.

`GET /me`

## Request

- Base URL: `https://forbiz.io/api/public/agent`
- URL: `https://forbiz.io/api/public/agent/me`
- Auth: HTTP bearer

## Response `200`

Identity

- object
  - `workspace_id` string, nullable
  - `agent_id` string
  - `actor_id` string, nullable
  - `membership_id` string, nullable
  - `grant_id` string, nullable
  - `grant_kind` 'legacy_blanket' | 'issued', nullable
  - `credential_class` 'legacy_full' | 'legacy_renewal_only' | 'renewal' | 'work_token' | 'human_token' | 'provisional_token', nullable
  - `credential` object
    - `credential_id` string
    - `token_id` string, nullable
    - `type` 'identity_token' | 'legacy_key' | 'renewal_credential'
    - `prefix` string, nullable
    - `scopes` string[]
    - `access_level` 'full' | 'read_only'
    - `expires_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `last_used_at` string, date-time, nullable
    - `issued_reason` string, nullable
  - `actor` object
    - `type` 'agent'
    - `id` string
    - `agent_id` string
    - `credential_id` string
    - `credential_type` 'identity_token' | 'legacy_key' | 'renewal_credential'
    - `name` string
    - `scopes` string[]
    - `access_level` 'full' | 'read_only'
    - `expires_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `last_used_at` string, date-time, nullable
  - `capabilities` string[]
  - `blocked_capabilities` string[]
  - `plan` 'trial' | 'continuity' | 'delegation'
  - `payment_status` 'none' | 'invoiced' | 'paid' | 'past_due'
  - `workspace` object
    - `id` string
    - `name` string
    - `type` string
  - `owner_user` object
    - `id` string
    - `display_name` string, nullable
  - `note` string

## Other responses

- `401`: Missing or invalid agent key
- `403`: read_only_credential — a [read] credential attempted a write operation; or renewal_only_credential — a renewal root credential attempted anything outside POST /identity/token and GET /me

---

[API](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api.md) · [All operations](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forbiz/apis/forbiz-external-agent-api/revisions/e5b10d59dc5f?raw)