Known Issue

Field	Type	Behavior	Description
name	string	OUTPUT_ONLY	Resource name (known-issues/{id})
title	string		Short title describing the known issue
context	string		Additional context about the issue (investigation notes, root cause, etc.)
human_description	string		Concise paragraph describing the problem, what’s known, and recommended action
status	KnownIssueStatus		Current status of the known issue
impacted_objectives	string[]		List of objective resource names affected by this issue
incidents	string[]		List of incident resource names related to this issue
issues	string[]		List of issue resource names (issues/{id}) linked to this known issue
links	string[]		External URLs relevant to the issue (tickets, postmortems, etc.)
session	string	OUTPUT_ONLY	Expert agent session that owns this known issue
create_time	timestamp	OUTPUT_ONLY	When the known issue was created
update_time	timestamp	OUTPUT_ONLY	When the known issue was last modified
delete_time	timestamp	OUTPUT_ONLY	When the known issue was soft-deleted (null if active)

Example

{
  "name": "known-issues/7f2aeed20da8",
  "title": "Webhook 401 authentication failures with token timeouts",
  "context": "## Root Cause: API Token Instability - RESOLVED\n\nFix deployed Feb 26, token caching eliminated the issue...",
  "humanDescription": "Chronic API token failures (Feb 13-26, ~880 failures) RESOLVED. Fix deployed Feb 26 achieved 97% immediate reduction, 100% elimination verified over 96 hours.",
  "status": "KNOWN_ISSUE_STATUS_RESOLVED",
  "issues": [
    "issues/789a4a343c01",
    "issues/eff5de83e6c4",
    "issues/d8c2e560c537"
  ],
  "links": [
    "https://example.slack.com/archives/C09ABC123/p1771796025097359"
  ],
  "session": "agents/known-issues-expert/sessions/ses-abc123",
  "createTime": "2026-02-22T21:33:33.826036Z",
  "updateTime": "2026-03-02T02:02:34.440248Z"
}

Known Issue Status

Value	Description
KNOWN_ISSUE_STATUS_UNSPECIFIED	Default value, not used
KNOWN_ISSUE_STATUS_ACTIVE	Issue needs attention and is being tracked
KNOWN_ISSUE_STATUS_RESOLVED	Issue has been fixed
KNOWN_ISSUE_STATUS_MUTED	Issue is acknowledged but deprioritized