.NET API
RetentionTargets
Tracon.Abstractions.dllThe fixed table list a retention policy may target.
public static class RetentionTargets- Inheritance
- object ← RetentionTargets
- Inherited Members
- object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”The target name is not free-form text: the allowed targets are this fixed list. Otherwise this would be a table-name injection surface.
audit_log is deliberately absent from this list.
The audit trail is never automatically deleted.
Fields
Section titled “Fields”Attachments
Section titled “ Attachments”Orphaned attachments and, when they are stored externally, their bytes.
public const string Attachments = "attachments"Field Value
Section titled “Field Value”Remarks
Section titled “Remarks”An attachment is orphaned when it has no session id, or when nothing in the same tenant owns its session id. An owner is a session, or a workflow run with that session id that waits for input, has not finished, or finished after the cutoff. With IAttachmentStorage registered, the bytes are deleted before the row; a row whose bytes cannot be deleted is kept for the next run.
Conversations
Section titled “ Conversations”Conversation history. Deletion cascades to its messages. User data; OFF by default.
public const string Conversations = "conversations"Field Value
Section titled “Field Value”DocumentEmbeddings
Section titled “ DocumentEmbeddings”Knowledge-base chunks and their embeddings. The table exists only in the PostgreSQL migration set; binding this target to a policy on SQL Server or SQLite fails at run time (no such table).
public const string DocumentEmbeddings = "document_embeddings"Field Value
Section titled “Field Value”EvalCaseResults
Section titled “ EvalCaseResults”Evaluation (eval) case results.
public const string EvalCaseResults = "eval_case_results"Field Value
Section titled “Field Value”IdempotencyKeys
Section titled “ IdempotencyKeys”Stored idempotency responses.
public const string IdempotencyKeys = "idempotency_keys"Field Value
Section titled “Field Value”Completed/failed/cancelled queue jobs. Deletion cascades to their items.
public const string Jobs = "jobs"Field Value
Section titled “Field Value”RunEvents
Section titled “ RunEvents”The run event stream (append-only).
public const string RunEvents = "run_events"Field Value
Section titled “Field Value”RunInputs
Section titled “ RunInputs”Runs’ recorded input messages. The source of replay; deleting an input makes that run unable to be replayed.
public const string RunInputs = "run_inputs"Field Value
Section titled “Field Value”Remarks
Section titled “Remarks”The content is in the same information class as conversation_items,
but the target is not off by default:
run_inputs is not the user’s own conversation history but a
derived record of the run, and its lifetime should be limitable
through the retention policy.
RunScores
Section titled “ RunScores”Run and message scores.
public const string RunScores = "run_scores"Field Value
Section titled “Field Value”Sessions
Section titled “ Sessions”Serialized session state. User data; OFF by default.
public const string Sessions = "sessions"Field Value
Section titled “Field Value”SkillScriptGrants
Section titled “ SkillScriptGrants”Expired or cancelled skill script execution grants.
public const string SkillScriptGrants = "skill_script_grants"Field Value
Section titled “Field Value”ToolInvocations
Section titled “ ToolInvocations”Tool call summaries.
public const string ToolInvocations = "tool_invocations"Field Value
Section titled “Field Value”Traces
Section titled “ Traces”OpenTelemetry trace headers. Deletion cascades to the spans.
public const string Traces = "traces"Field Value
Section titled “Field Value”VoiceSessions
Section titled “ VoiceSessions”The summary record of closed real-time voice connections.
public const string VoiceSessions = "voice_sessions"Field Value
Section titled “Field Value”Remarks
Section titled “Remarks”The record carries no audio; it only carries duration, turn count, and measurements. If the conversation’s audio was stored (default: no), the bytes fall under the RetentionTargets.Attachments target’s scope.
WebhookDeliveries
Section titled “ WebhookDeliveries”Delivered webhook delivery-history records.
public const string WebhookDeliveries = "webhook_deliveries"Field Value
Section titled “Field Value”WorkflowCheckpoints
Section titled “ WorkflowCheckpoints”Workflow checkpoints of completed runs.
public const string WorkflowCheckpoints = "workflow_checkpoints"Field Value
Section titled “Field Value”WorkflowRequests
Section titled “ WorkflowRequests”The inbox rows of workflow requests whose run was closed because the request expired (WorkflowDefinition.RequestTimeout).
public const string WorkflowRequests = "workflow_requests"Field Value
Section titled “Field Value”Remarks
Section titled “Remarks”Only a closed row is deleted: a row of a run that still waits for an answer is the request’s entry in the inbox. The row carries a session id, a request id and a workflow name, no prompt and no answer; it is not user data, so the configuration-based default applies.
Properties
Section titled “Properties”All recognized target names.
public static IReadOnlyList<string> All { get; }Property Value
Section titled “Property Value”UserDataTargets
Section titled “ UserDataTargets”The targets that carry user data and are OFF by default.
public static IReadOnlyList<string> UserDataTargets { get; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”A policy can be created for these targets, but no row is deleted
unless RetentionPolicy.Enabled is explicitly set to
true. Configuration-based defaults
(TraconRetentionOptions) also do not apply to these
targets — only an explicit database policy takes effect.
Methods
Section titled “Methods”IsKnown(string?)
Section titled “ IsKnown(string?)”Reports whether a target name is recognized.
public static bool IsKnown(string? target)Parameters
Section titled “Parameters”target string?
The target name.
Returns
Section titled “Returns”true if the name is recognized.