---
title: "Update Perspective Settings"
method: PUT
path: "/api/mind/v2/perspective/{identity_id}/settings"
tags: ["mind-v2"]
---

# Update Perspective Settings

`PUT /api/mind/v2/perspective/{identity_id}/settings`

## 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}/settings`
- Auth: none declared

TOS-1981: set this Mind's consolidation_authority.

OWNER-ONLY: `_check_perspective_access` is the strictest existing check
(self OR an active agent owner) - the same gate every sibling perspective
route already uses for reads, reused here unchanged for the write.

manual -> auto releases every 'pending_review' evaluation on this Mind to
'active' and bumps mind_version, in the SAME transaction as the setting
change - the owner opting back into auto review must immediately surface
whatever was quarantined, not leave it stuck until the next unrelated
write. auto -> manual affects only FUTURE consolidation writes; existing
active rows are left untouched.

## Path parameters

- `identity_id` string, uuid, required

## Headers

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

## Request body

- V2PerspectiveSettings: TOS-1981: GET/PUT .../perspective/{identity_id}/settings body. Mirrors ``IdentityConfig.consolidation_authority`` exactly (models/ identity_config.py) - 'auto' (default) lets a freshly consolidated abstraction join ranking immediately; 'manual' quarantines it (lifecycle_status='pending_review') until the owner confirms/dismisses it in the Mind Journal.
  - `consolidation_authority` 'auto' | 'manual', required

## Response `200`

Successful Response

- V2PerspectiveSettings: TOS-1981: GET/PUT .../perspective/{identity_id}/settings body. Mirrors ``IdentityConfig.consolidation_authority`` exactly (models/ identity_config.py) - 'auto' (default) lets a freshly consolidated abstraction join ranking immediately; 'manual' quarantines it (lifecycle_status='pending_review') until the owner confirms/dismisses it in the Mind Journal.
  - `consolidation_authority` 'auto' | 'manual', 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/5387b4ded614?raw)