Skip to content

SpanGetResponse

A single execution span returned by the Traces API.

Properties

Property Type Description
agentVersion null | string Version of the agent runtime.
attachments null | SpanAttachment[] File or payload attachments linked to this span.
attributes Record<string, unknown> Span attributes (user-defined schema — do not transform keys). Values depend on the span type and the agent that produced them.
context null | SpanContext Reference hierarchy context for this span.
endTime null | string ISO-8601 UTC timestamp when the span ended, or null if still running.
executionType null | SpanExecutionType Whether this span was from a debug or runtime execution.
expiredTime null | string Expiry timestamp, or null if the span does not expire.
folderKey null | string Folder key (GUID) scoping this span.
id string Unique identifier of this span (GUID).
jobKey null | string Key of the job associated with this span.
name null | string Human-readable name of the operation, or null if the span has no name.
organizationId string Organization (account) GUID.
parentId null | string Parent span ID, or null for root spans.
permissionStatus null | SpanPermissionStatus Whether the caller can read this span's data.
processKey null | string Key of the process associated with this span.
referenceId null | string Identifier of the entity (agent, process, etc.) that produced the span.
referenceVersion null | string Version of the entity that produced the span.
source null | SpanSource Platform source that produced the span.
spanType null | string Span type tag (e.g. "agentRun", "llmCall").
startTime string ISO-8601 UTC timestamp when the span started.
status SpanStatus Completion status of the span.
tenantId null | string Tenant GUID.
traceId string Trace this span belongs to (GUID).
updatedAt string ISO-8601 UTC timestamp of last update.
verbosityLevel null | SpanVerbosityLevel Minimum verbosity level captured in this span.