n8n/docs/generated/postgres-schema/public.instance_ai_checkpoints.md

public.instance_ai_checkpoints

Columns

Name	Type	Default	Nullable	Children	Parents	Comment
createdAt	timestamp(3) with time zone	CURRENT_TIMESTAMP(3)	false
expiredAt	timestamp(3) with time zone		true			Soft-delete timestamp: null means live; non-null marks the row as a tombstone.
hostRunId	varchar(64)		true			Host (Instance AI) run id; distinct from the agent-SDK runId parsed from the checkpoint key.
key	varchar(255)		false	public.instance_ai_pending_confirmations		Opaque checkpoint key from the agent runtime.
resourceId	varchar(255)		true			Resource ID recorded by the agent runtime.
runId	varchar(255)		true			Run ID parsed from the checkpoint key when available.
state	json		true			Serializable agent state snapshot stored as JSON.
threadId	uuid		false		public.instance_ai_threads	Instance AI thread that owns the checkpoint.
updatedAt	timestamp(3) with time zone	CURRENT_TIMESTAMP(3)	false

Constraints

Name	Type	Definition
FK_2b23f3f24a70bebb990203b011e	FOREIGN KEY	FOREIGN KEY ("threadId") REFERENCES instance_ai_threads(id) ON DELETE CASCADE
PK_5315a45f0846d1f9d128c18a2ed	PRIMARY KEY	PRIMARY KEY (key)
instance_ai_checkpoints_createdAt_not_null	n	NOT NULL "createdAt"
instance_ai_checkpoints_key_not_null	n	NOT NULL key
instance_ai_checkpoints_state_tombstone_check	CHECK	CHECK (((("expiredAt" IS NOT NULL) AND (state IS NULL)) OR ("expiredAt" IS NULL)))
instance_ai_checkpoints_threadId_not_null	n	NOT NULL "threadId"
instance_ai_checkpoints_updatedAt_not_null	n	NOT NULL "updatedAt"

Indexes

Name	Definition
IDX_2b23f3f24a70bebb990203b011	CREATE INDEX "IDX_2b23f3f24a70bebb990203b011" ON public.instance_ai_checkpoints USING btree ("threadId")
IDX_768189b506cc26c4fe878b87cb	CREATE INDEX "IDX_768189b506cc26c4fe878b87cb" ON public.instance_ai_checkpoints USING btree ("runId")
IDX_be9d0eca0b19fb93d4eb74b327	CREATE INDEX "IDX_be9d0eca0b19fb93d4eb74b327" ON public.instance_ai_checkpoints USING btree ("resourceId")
PK_5315a45f0846d1f9d128c18a2ed	CREATE UNIQUE INDEX "PK_5315a45f0846d1f9d128c18a2ed" ON public.instance_ai_checkpoints USING btree (key)

Relations

erDiagram

"public.instance_ai_pending_confirmations" }o--o| "public.instance_ai_checkpoints" : "FOREIGN KEY (#quot;checkpointKey#quot;) REFERENCES instance_ai_checkpoints(key) ON DELETE CASCADE"
"public.instance_ai_checkpoints" }o--|| "public.instance_ai_threads" : "FOREIGN KEY (#quot;threadId#quot;) REFERENCES instance_ai_threads(id) ON DELETE CASCADE"

"public.instance_ai_checkpoints" {
  timestamp_3__with_time_zone createdAt
  timestamp_3__with_time_zone expiredAt
  varchar_64_ hostRunId
  varchar_255_ key
  varchar_255_ resourceId
  varchar_255_ runId
  json state
  uuid threadId FK
  timestamp_3__with_time_zone updatedAt
}
"public.instance_ai_pending_confirmations" {
  varchar_255_ checkpointKey FK
  varchar_36_ checkpointTaskId
  timestamp_3__with_time_zone createdAt
  timestamp_3__with_time_zone expiresAt
  varchar_16_ kind
  varchar_36_ messageGroupId
  varchar_36_ requestId
  varchar_36_ runId
  uuid threadId FK
  varchar_64_ toolCallId
  timestamp_3__with_time_zone updatedAt
  uuid userId FK
}
"public.instance_ai_threads" {
  timestamp_3__with_time_zone createdAt
  uuid id
  json metadata
  varchar_36_ projectId FK
  varchar_255_ resourceId
  text title
  timestamp_3__with_time_zone updatedAt
}

---

Generated by tbls