latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-14129143297.4 KB

0e52fe5f8d33

admin

Export Shared Data User

One-shot export bundle for a consenting user.

Designed for CLI / offline analysis: a single audit-logged request returns identity + profile + memory + heartbeat history + activity counts + tool usage rollup, all PII-redacted. Without this, an admin investigating "what's wrong with this user's experience?" has to walk seven separate endpoints by hand.

The window only applies to time-bucketed sub-resources. The profile / memory / consent fields are always the current value.

Bodies live in two places:

  • The agent's persistent text (soul, user, heartbeat directives, memory) returns in the corresponding sections.
  • Per-message transcripts only return when include_turns=true. They are the heaviest field (one row per message + tool call).
get/api/admin/shared-data/users/{user_id}/export

Path parameters

user_idstring required

Query parameters

daysinteger

Window size in days, ending now. Scopes the time-bucketed subresources (conversations, heartbeat-logs, compaction-events, LLM-usage, reports, and the tool-call rollup). Identity, profile, and memory are point-in-time and not scoped by the window.

Window size in days, ending now. Scopes the time-bucketed subresources (conversations, heartbeat-logs, compaction-events, LLM-usage, reports, and the tool-call rollup). Identity, profile, and memory are point-in-time and not scoped by the window.

include_turnsboolean

When true, attach turn-grouped transcripts for every conversation in the window. Off by default because turns are expensive both to compute and to ship; flip on when you want full body content.

When true, attach turn-grouped transcripts for every conversation in the window. Off by default because turns are expensive both to compute and to ship; flip on when you want full body content.

Response

Successful Response

user_idstring required
userobject required
windowobject required