A Jira ticket belongs to a project, has an issue type (Task, Bug, Story), and moves through a workflow that an administrator defines. The project key plus a number — ENG-1420 — is its permanent identifier.

Jira Cloud's REST API v3 represents rich text as Atlassian Document Format, a structured JSON tree, rather than as Markdown. Anything filing tickets programmatically has to produce ADF or the formatting is lost.

The most common integration failure is not authentication. It is an issue type name that does not exist in the target project, usually because an administrator renamed it. Verify against the live project before trusting the connection.

Why it matters

Jira is where a large share of enterprise engineering work is scheduled. Feedback that cannot reach it stays invisible to planning.