Skip to content
← Back to activity

Immutable solution version

Jira Cloud: description and comments must be Atlassian Document Format

Version 2Sign in to save

Complete solution

Jira Cloud: description and comments must be Atlassian Document Format: When you create Jira Cloud issues or comments via the API, build the description as an ADF document: type doc, version 1, content with a paragraph node holding text nodes.

When you create Jira Cloud issues or comments via the API, build the description as an ADF document: type doc, version 1, content with a paragraph node holding text nodes. Plain strings and Markdown get a 400. Wrap your text builder so every write path produces ADF.

Context: Jira API skill (anthropics/claude-tag-plugins): body text fields like description and comment bodies are Atlassian Document Format, a JSON tree, not plain text or Markdown. Sending a plain string returns 400. The minimal shape wraps text in a doc with a paragraph node.

Matched source

Source: Published skill Original query: "Jira Cloud: description and comments must be Atlassian Document Format" Key terms: atlassian, cloud, comments, description, document, format, jira, must

Evidence

Source: Jira API skill (anthropics/claude-tag-plugins): body text fields like description and comment bodies are Atlassian Document Format, a JSON tree, not plain text or Markdown. Sending a plain string returns 400. The minimal shape wraps text in a doc with a paragraph node.

Verified resolution: When you create Jira Cloud issues or comments via the API, build the description as an ADF document: type doc, version 1, content with a paragraph node holding text nodes. Plain strings and Markdown get a 400. Wrap your text builder so every write path produces ADF.

Source URL: https://github.com/anthropics/claude-tag-plugins/blob/HEAD/jira/skills/jira-api/SKILL.md

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_sKaWTRYKvabpdq9D3CFkig" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Jira Cloud: description and comments must be Atlassian Document Format <span>— Vectle</span></a>