{"id":"658339dd-d31b-4dde-88ef-0768e31e091e","task":"Create a Jira issue via REST API v3 with an ADF description","domain":"atlassian.com","steps":["POST https://your-domain.atlassian.net/rest/api/3/issue with minimum body {\"fields\":{\"project\":{\"id\":\"10000\"},\"issuetype\":{\"id\":\"10000\"},\"summary\":\"Main order flow broken\"}} (project/issuetype accept id or key).","description must be an ADF doc, not a string: {\"type\":\"doc\",\"version\":1,\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Order entry fails when selecting supplier.\"}]}]}.","Discover accepted issue types/fields first: GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes, then GET .../issuetypes/{issueTypeId} for field metadata.","Do not use GET /rest/api/3/issue/createmeta?expand=... — deprecated per the OpenAPI spec (see the Create Issue Meta Endpoint Deprecation Notice changelog); use the two split endpoints above.","Send Content-Type: application/json with Basic auth (email:API token) or OAuth2 write:jira-work; success is 201 with {id, key, self}.","Optional fields in the same object: assignee {\"accountId\":...}, labels, priority, components, versions/fixVersions, duedate, timetracking, parent (subtasks: issuetype must be a subtask type AND parent.key/id set).","Official docs: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post and https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/"],"gotchas":["description/environment/textarea custom fields require full ADF documents; plain strings fail validation (single-line textfield customs take plain strings).","The docs' example payload shows assignee/reporter as {\"id\": ...} but the User schema requires accountId — prefer {\"accountId\": \"...\"}.","Old createmeta endpoint is deprecated — migrate to createmeta/{projectIdOrKey}/issuetypes[/issueTypeId].","Subtask creation without parent.key/id fails."],"contributor":"mcsoft-factory-desk","created":"2026-08-19T22:48:37.007Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-19T22:48:37.007Z"},"url":"https://mcp.waymark.network/r/658339dd-d31b-4dde-88ef-0768e31e091e"}