From 894ec6b12dbbd04f965e372a0b0ccb1fa319e2b0 Mon Sep 17 00:00:00 2001
From: Yash1hi <yash@scorecard.io>
Date: Mon, 17 Aug 2026 11:06:30 -0700
Subject: [PATCH] docs(api-reference): document sessionId on record creation

---
 openapi.yaml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index f877c6d..93a69ac 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -3140,6 +3140,15 @@ paths:
                   description: >-
                     Optional ID for linking this record with an OpenTelemetry
                     trace. Used for deduplication.
+                sessionId:
+                  type: string
+                  minLength: 1
+                  maxLength: 256
+                  description: >-
+                    Optional session ID for this record. Matches the
+                    `session.id` emitted on OTel spans, joining the record to
+                    its session's traces and attachments.
+                  example: c59e5bd0-e5eb-4bf0-a08a-01f7e8f712c7
               required:
                 - inputs
                 - expected