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
services string[]   Service resource names (services/{service}) this issue belongs to. Set by the triage agent so the issue is discoverable from (and dedup-able per) its Service.
objectives string[]   Objective resource names (objectives/{objective}) this issue belongs to. Set by the triage agent on an objective-breach escalation so the issue is discoverable from (and dedup-able per) its Objective.
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

Validate Issue Evidence Response

Field Type Behavior Description
decision IssueEvidenceValidationDecision   Validation decision for the proposed issues
passes boolean   Convenience boolean. True for ISSUE_EVIDENCE_VALIDATION_DECISION_PASS and ISSUE_EVIDENCE_VALIDATION_DECISION_SKIPPED; false only for ISSUE_EVIDENCE_VALIDATION_DECISION_FAIL
feedback string   Human-readable validation feedback
findings IssueEvidenceValidationFinding[]   Per-issue validation findings
validator_version string   Validator version that produced the response

Example

{
  "decision": "ISSUE_EVIDENCE_VALIDATION_DECISION_FAIL",
  "passes": false,
  "feedback": "Missing same-window baseline for the temporal anomaly claim.",
  "findings": [
    {
      "issueRef": "Checkout API errors increased",
      "feedback": "The evidence compares against yesterday, but does not include a same-day historical baseline."
    }
  ],
  "validatorVersion": "issue-evidence-v1"
}

Issue Evidence Validation Decision

Value Description
ISSUE_EVIDENCE_VALIDATION_DECISION_UNSPECIFIED Default value, not used
ISSUE_EVIDENCE_VALIDATION_DECISION_PASS Every proposed issue is supported by the supplied evidence
ISSUE_EVIDENCE_VALIDATION_DECISION_FAIL At least one proposed issue lacks sufficient supporting evidence
ISSUE_EVIDENCE_VALIDATION_DECISION_SKIPPED Validation was not configured or could not complete; callers should treat this as fail-open unless they require stricter policy

Issue Evidence Validation Finding

Field Type Description
issue_ref string Issue name or title that the finding applies to
feedback string Issue-specific validation feedback

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
This site uses Just the Docs, a documentation theme for Jekyll.