---
title: "Update a GEO persona"
method: PATCH
path: "/v1/projects/{projectId}/geo/personas/{personaId}"
tags: ["GEO"]
---

# Update a GEO persona

`PATCH /v1/projects/{projectId}/geo/personas/{personaId}`

## Request

- Base URL: `https://api.usenotra.com`
- URL: `https://api.usenotra.com/v1/projects/{projectId}/geo/personas/{personaId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/usenotra/apis/notra-api/docs/v1/projects/:projectId/geo/personas/:personaId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Turns a persona on or off for scheduled scans, or edits its details. Editing details clears its conversation prompts, so call `POST …/personas/generate` with `personaId` and `promptsOnly: true` before running it again. Archived personas must be restored first.

## Path parameters

- `projectId` string, required
- `personaId` string, required

## Request body

- PatchGeoPersonaRequest
  - `enabled` boolean
  - `name` string
  - `role` string
  - `company` string
  - `summary` string
  - `searchStyle` string
  - `profile` object: Lists to replace. Omitted lists keep their value.
    - `goals` string[]
    - `painPoints` string[]
    - `currentStack` string[]
    - `buyingTriggers` string[]
    - `objections` string[]

## Response `200`

Persona updated successfully

- GeoPersonaResponse
  - `persona` GeoPersona, required
    - `id` string, required
    - `name` string, required: Buyer archetype label, such as Budgeter.
    - `role` string, required
    - `company` string, required
    - `summary` string, required
    - `searchStyle` string, required
    - `profile` object, required
      - `goals` string[], required
      - `painPoints` string[], required
      - `currentStack` string[], required
      - `buyingTriggers` string[], required
      - `objections` string[], required
    - `conversationPrompts` string[], required: Opening prompts the persona plays against each engine. Cleared when its details change; regenerate them with `promptsOnly` before the next run.
    - `enabled` boolean, required: Whether scheduled scans play this persona.
    - `archivedAt` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `memories` object[], required
      - `id` string, required
      - `kind` 'background' | 'experience' | 'preference' | 'constraint', required
      - `content` string, required
  - `organization` object, required
    - `id` string, required
    - `slug` string, required
    - `name` string, required
    - `logo` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `402`: GEO plan or available AI credits required
- `403`: Forbidden
- `404`: Organization, project or resource not found
- `409`: Conflict
- `500`: Internal server error
- `503`: Authentication or billing service unavailable

## Changes

- **2026-11-05** `200d2ac38976`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usenotra/apis/notra-api/changes/v1/projects/:projectId/geo/personas/:personaId/patch.md)

---

[API](https://skmtc.dev/usenotra/apis/notra-api.md) - [All operations](https://skmtc.dev/usenotra/apis/notra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usenotra/apis/notra-api/revisions/607f9fffb6c7?raw)