Jira ticket from failed run Zof Documentation

Overview

Auto-create Jira issues with run artifacts attached.

Examples use staging environments and synthetic identifiers. Replace project IDs, suite names, and webhook URLs with your organization values.

Prerequisites

Organization API key or authenticated CLI
Staging environment for safe experimentation

Step-by-step procedure

Prepare environment

Store ZOF_API_KEY in CI secrets or local env.

Confirm target project and suite IDs in Console.

Apply pattern

Copy example configuration into your pipeline or service.

Adjust environment names and notification channels.

Validate

Run once manually before enforcing gates.

Capture run ID in runbook for support reference.

Example implementation

// Webhook handler excerpt
if (event.type === 'run.failed') {
  await jira.createIssue({
    project: 'QA',
    summary: `Validation failed: ${event.data.run_id}`,
    description: `Run: ${event.data.run_url}\nFailed cases: ${event.data.failed_count}`,
  });
}