Update group
Patch name, prompt, and/or status. Changing prompt does
not retroactively re-tag memory rows that were tagged under the
previous prompt.
Authorizations
Long-lived org API key. Alternative: Authorization: Bearer <key>.
Path Parameters
Body
PATCH /v1/groups/{id} — partial update. Any field set to None
is left unchanged. Editing prompt does NOT retroactively re-tag
existing memory rows.
New name; leave null to keep existing.
1 - 120New classifier prompt; leave null to keep existing. Does not retroactively re-tag existing memory rows. Setting a prompt on a catch-all group converts it to a prompted group going forward; a prompt can never be removed via PATCH (empty string is a 422).
1 - 2000Set to "active" to un-archive a previously-archived group. The normal way to archive is DELETE /v1/groups/{id}.
active, archived Response
Successful Response
Wire shape of a group. id is the opaque handle that goes
into IngestRequest.group_ids and into search filters.
Stable group id of the form grp_<32-hex-chars>.
"grp_a1b2c3d4e5f6071829304a5b6c7d8e9f"
Human-readable label.
active groups are tagged on new ingests. archived groups still surface on search (rows tagged with the id stay reachable) but the ingest classifier rejects them.
active, archived ISO-8601 timestamp the group was registered.
Constant discriminator for the resource type.
"group"Classifier criterion. Read by the ingest pipeline on every request that includes this group's id in group_ids. null marks a catch-all group: every extracted memory judged shareable (not personal) is tagged with it.
ISO-8601 timestamp of the most recent edit.