Issue

Field	Type	Behavior	Description
`name`	string	OUTPUT_ONLY	Resource name (`issues/{id}`)
`title`	string		Short title for the issue
`description`	string		Detailed description of the detected issue
`details`	string		Extended details and context
`workflow_state`	IssueWorkflowState		Current workflow state
`closure`	IssueClosure		Closure details when the issue is resolved or dismissed
`expert_session`	string		Agent session investigating this issue
`observations`	IssueObservations		Observation timestamps and counts
`tags`	string[]		Tag resource names (`tags/{tag}`)
`deployment_environments`	string[]		Deployment environment resource names (`deployment-environments/{environment}`) affected by the issue
`links`	string[]		Related links
`pull_requests`	string[]		GitHub PR URLs linked to this issue as fix attempts
`source`	string		Canonical issue lineage. Can be an agent (`agents/my-agent`), an agent session (`agents/my-agent/sessions/abc`), an investigation (`investigations/xyz`), a deployment environment (`deployment-environments/firetiger-cloud`), or an external URL (`https://incident.io/incident/123`)
`create_time`	timestamp	OUTPUT_ONLY	When the issue was created
`update_time`	timestamp	OUTPUT_ONLY	When the issue was last modified
`delete_time`	timestamp	OUTPUT_ONLY	When the issue was soft-deleted (null if active)

Example

{
  "name": "issues/db80f50ddbf7",
  "title": "S3 Timeout Errors Escalating",
  "description": "datafile-optimizer-plan experiencing 2,839 errors/hour (+22.3% from previous hour), representing 71.2% of planner errors. Errors include 'context canceled' and 'operation error S3: HeadObject/GetObject, context deadline exceeded'.",
  "source": "deployment-environments/firetiger-cloud",
  "deploymentEnvironments": [
    "deployment-environments/firetiger-cloud",
    "deployment-environments/ft-ramp"
  ],
  "createTime": "2026-02-13T01:04:27.924994Z",
  "updateTime": "2026-02-13T01:04:27.924994Z"
}

Issue Workflow State

Value	Description
`ISSUE_WORKFLOW_STATE_UNSPECIFIED`	Default value, not used
`ISSUE_WORKFLOW_STATE_INVESTIGATING`	Issue is being investigated
`ISSUE_WORKFLOW_STATE_ACTIONABLE`	Issue requires action
`ISSUE_WORKFLOW_STATE_VERIFYING_FIX`	A fix has been applied and is being verified
`ISSUE_WORKFLOW_STATE_CLOSED`	Issue is closed

Issue Closure

Field	Type	Description
`reason`	IssueCloseReason	Why the issue was closed
`dismissal`	IssueDismissal	Dismissal details

Issue Close Reason

Value	Description
`ISSUE_CLOSE_REASON_UNSPECIFIED`	Default value, not used
`ISSUE_CLOSE_REASON_RESOLVED`	The underlying problem was fixed
`ISSUE_CLOSE_REASON_ACCEPTED_RISK`	The issue is acknowledged but accepted
`ISSUE_CLOSE_REASON_FALSE_POSITIVE`	The issue was incorrectly identified
`ISSUE_CLOSE_REASON_DUPLICATE`	Duplicate of another issue
`ISSUE_CLOSE_REASON_NOT_USEFUL`	The issue is not useful

Issue Dismissal

Field	Type	Description
`comment`	string	Reason for dismissal
`dismissed_by`	string	Who dismissed the issue
`dismissed_time`	timestamp	When the issue was dismissed

Issue Observations

Field	Type	Description
`first_observation_time`	timestamp	When the issue was first observed
`last_observation_time`	timestamp	When the issue was last observed
`observation_count`	int32	Number of times the issue has been observed
`first_source_session`	string	Session that first observed the issue
`last_source_session`	string	Session that most recently observed the issue

Issue Notification Policy

Field	Type	Behavior	Description
`name`	string	OUTPUT_ONLY	Resource name (`issue-notification-policies/{id}`)
`description`	string		Human-readable description of the policy
`connections`	string[]		List of connection resource names (`connections/{id}`) used for sending notifications
`prompt`	string		Instructions for the notification agent defining routing rules, channel selection, and formatting preferences
`state`	IssueNotificationPolicyState		Current state of the policy
`review_reason`	string		Explanation of why the policy needs review (populated when state is `REVIEW_REQUIRED`)
`planner_session`	string		Agent session managing the notification planner
`create_time`	timestamp	OUTPUT_ONLY	When the policy was created
`update_time`	timestamp	OUTPUT_ONLY	When the policy was last modified
`delete_time`	timestamp	OUTPUT_ONLY	When the policy was soft-deleted (null if active)
`purge_time`	timestamp	OUTPUT_ONLY	When the policy is scheduled for permanent deletion

Example

{
  "name": "issue-notification-policies/default",
  "description": "Send notifications to Slack (#alerts) and create Linear issues for all detected issues.",
  "connections": [
    "connections/slack-workspace",
    "connections/linear-project"
  ],
  "prompt": "When an issue is created or updated, send notifications using both channels...",
  "state": "ISSUE_NOTIFICATION_POLICY_STATE_ACTIVE",
  "plannerSession": "agents/issue-notification-planner-agent/sessions/ses-def456",
  "createTime": "2026-02-28T01:09:28.105790Z",
  "updateTime": "2026-03-04T01:34:50.035946Z"
}

Issue Notification Policy State

Value	Description
`ISSUE_NOTIFICATION_POLICY_STATE_UNSPECIFIED`	Default value, not used
`ISSUE_NOTIFICATION_POLICY_STATE_ACTIVE`	Policy is active and will send notifications when issues are detected
`ISSUE_NOTIFICATION_POLICY_STATE_REVIEW_REQUIRED`	Policy needs human review before it will send notifications