manage_person
Create, fetch, update, or delete Gramps person records using this API tool. Supports listing, retrieval by handle, and full CRUD operations with schema-compliant payloads.
Instructions
Create, read, update or delete Gramps Person records. Writes: create, update, delete.
action=get lists people (handle empty, paginated) or returns one person
(handle set, ?profile=&extend= via query). action=create posts a
full Person JSON object in data (handles are assigned by the server).
action=update PUTs data to /people/; action=delete removes it.
Person payload fields follow the Gramps schema (gramps_id, gender,
primary_name, names, event_ref_list, family_list, person_ref_list,
attribute_list, media_list, address_list, url_list, note_list, change, ...).
Args: action: The operation, "get", "create", "update" or "delete". handle: Person handle (e.g. 'P0001'); required for get-one, update, delete. data: The Person object for create/update (required for those). query: Optional dict of extra query-string parameters (e.g. {"page": 1, "pagesize": 20, "keys": "handle,name", "strip": true, "profile": "all", "extend": "all", "locale": "en"}). instance: Gramps Web base URL from get_instances; default = first.
Returns: dict: {"status": , "url": , "data": <object(s) | transaction>}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | No | ||
| query | No | ||
| action | Yes | ||
| handle | No | ||
| instance | No |