---
title: "Get Person Entity"
method: GET
path: "/api/mind/v2/perspective/{identity_id}/person-entity"
tags: ["mind-v2"]
---

# Get Person Entity

`GET /api/mind/v2/perspective/{identity_id}/person-entity`

## Request

- Base URL: `https://app.thinqos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.thinqos.com/api/mind/v2/perspective/{identity_id}/person-entity`
- Auth: none declared

Resolve the canonical person Entity bound to `identity_id` (W8 fix).

The theory-of-mind UI needs the viewer's own person Entity to ask
other Minds "what do you believe about me". Scraping it from the
current Mind's graph payload fails when that Mind holds no
proposition about the viewer. This resolves it authoritatively from
the world graph (design W2: one active person Entity per identity).

Identity-scoped through the SAME `_check_perspective_access` gate
every sibling endpoint uses. `entity_id` is null when none exists.

## Path parameters

- `identity_id` string, uuid, required

## Headers

- `x-impersonate-identity-id` string, nullable

## Response `200`

Successful Response

- V2PersonEntityResponse: The single canonical person Entity bound to an identity (design W2). `entity_id` is null when no active person Entity exists for the identity yet. Used by the theory-of-mind UI to resolve "me" authoritatively, independent of any one Mind's graph scope.
  - `identity_id` string, uuid, required
  - `entity_id` string, uuid, nullable, required

## Other responses

- `422`: Validation Error

---

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