{"slug":"jira-and-confluence-cloud-rest-apis","name":"Jira and Confluence Cloud REST APIs","host":"*.atlassian.net","site":"https://atlassian.net","category":"productivity","docsUrl":null,"sources":[{"kind":"changelog","url":"https://developer.atlassian.com/cloud/confluence/changelog/"},{"kind":"changelog","url":"https://developer.atlassian.com/cloud/jira/platform/changelog/"},{"kind":"changelog","url":"https://developer.atlassian.com/cloud/jira/software/changelog/"},{"kind":"openapi","url":"https://developer.atlassian.com/cloud/confluence/openapi-v2.v3.json"},{"kind":"openapi","url":"https://developer.atlassian.com/cloud/confluence/swagger.v3.json"},{"kind":"openapi","url":"https://developer.atlassian.com/cloud/jira/platform/swagger.v3.json"},{"kind":"openapi","url":"https://developer.atlassian.com/cloud/jira/platform/swagger-v3.v3.json"},{"kind":"openapi","url":"https://developer.atlassian.com/cloud/jira/service-desk/swagger.v3.json"},{"kind":"openapi","url":"https://developer.atlassian.com/cloud/jira/software/swagger.v3.json"},{"kind":"archive","url":"https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-search/"},{"kind":"archive","url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-contexts/"},{"kind":"archive","url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/"},{"kind":"archive","url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/"},{"kind":"archive","url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-expressions/"},{"kind":"archive","url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflows/"}],"url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/","json":"https://www.okapi.bot/api/v1/providers/jira-and-confluence-cloud-rest-apis.json","breakingChanges":[{"slug":"get-rest-api-3-field-context-defaultvalue-stops-working","api":"jira-and-confluence-cloud-rest-apis","title":"GET /rest/api/3/field/{}/context/defaultValue stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-10-01","scope":null,"calls":["GET /rest/api/3/field/{}/context/defaultValue"],"method":"GET","path":"/rest/api/3/field/{}/context/defaultValue","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-contexts/","kind":"archive"},"quote":"This API is deprecated and will be removed in October 2026. A replacement API that supports multiple default values per issue type within a context is coming soon.","migration":"Move to the replacement custom field context default value API Atlassian announces under CHANGE-3082.","migrationChange":null,"needsDecision":"Atlassian's replacement API was announced as coming soon: someone must check it is available before migrating.","text":null,"publishedAt":"2026-10-23T10:32:21.618Z","updatedAt":"2026-10-23T10:32:21.618Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/get-rest-api-3-field-context-defaultvalue-stops-working/"},{"slug":"put-rest-api-3-field-context-defaultvalue-stops-working","api":"jira-and-confluence-cloud-rest-apis","title":"PUT /rest/api/3/field/{}/context/defaultValue stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-10-01","scope":null,"calls":["PUT /rest/api/3/field/{}/context/defaultValue"],"method":"PUT","path":"/rest/api/3/field/{}/context/defaultValue","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-custom-field-contexts/","kind":"archive"},"quote":"This API is deprecated and will be removed in October 2026. A replacement API that supports multiple default values per issue type within a context is coming soon.","migration":"Move to the replacement custom field context default value API Atlassian announces under CHANGE-3082.","migrationChange":null,"needsDecision":"Atlassian's replacement API was announced as coming soon: someone must check it is available before migrating.","text":null,"publishedAt":"2026-10-23T10:32:21.618Z","updatedAt":"2026-10-23T10:32:21.618Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/put-rest-api-3-field-context-defaultvalue-stops-working/"},{"slug":"get-rest-api-3-workflow-search-stops-working","api":"jira-and-confluence-cloud-rest-apis","title":"GET /rest/api/3/workflow/search stops working","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":"2026-06-01","scope":null,"calls":["GET /rest/api/3/workflow/search"],"method":"GET","path":"/rest/api/3/workflow/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflows/","kind":"archive"},"quote":"This will be removed on June 1, 2026; use Search workflows instead.","migration":"Call GET /rest/api/3/workflows/search instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:19.670Z","updatedAt":"2026-10-23T10:32:19.670Z","status":"in_effect","tone":"broken","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/get-rest-api-3-workflow-search-stops-working/"},{"slug":"get-rest-api-2-search-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"GET /rest/api/2/search is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["GET /rest/api/2/search"],"method":"GET","path":"/rest/api/2/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-search/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call GET /rest/api/2/search/jql: it pages with nextPageToken instead of startAt and returns only ids unless fields are requested.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:11.529Z","updatedAt":"2026-10-23T10:32:11.529Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/get-rest-api-2-search-is-deprecated/"},{"slug":"get-rest-api-3-issue-createmeta-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"GET /rest/api/3/issue/createmeta is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":null,"effectiveAt":null,"scope":null,"calls":["GET /rest/api/3/issue/createmeta"],"method":"GET","path":"/rest/api/3/issue/createmeta","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/","kind":"archive"},"quote":"Deprecated, see Create Issue Meta Endpoint Deprecation Notice.","migration":"Call GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes, then GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId} for the fields.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:25.672Z","updatedAt":"2026-10-23T10:32:25.672Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/get-rest-api-3-issue-createmeta-is-deprecated/"},{"slug":"get-rest-api-3-search-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"GET /rest/api/3/search is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["GET /rest/api/3/search"],"method":"GET","path":"/rest/api/3/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call GET /rest/api/3/search/jql: it pages with nextPageToken instead of startAt and returns only ids unless fields are requested.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:03.961Z","updatedAt":"2026-10-23T10:32:03.961Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/get-rest-api-3-search-is-deprecated/"},{"slug":"get-rest-api-latest-search-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"GET /rest/api/latest/search is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["GET /rest/api/latest/search"],"method":"GET","path":"/rest/api/latest/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call GET /rest/api/latest/search/jql: it pages with nextPageToken instead of startAt and returns only ids unless fields are requested.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:03.961Z","updatedAt":"2026-10-23T10:32:03.961Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/get-rest-api-latest-search-is-deprecated/"},{"slug":"post-rest-api-2-expression-eval-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"POST /rest/api/2/expression/eval is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["POST /rest/api/2/expression/eval"],"method":"POST","path":"/rest/api/2/expression/eval","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-expressions/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call POST /rest/api/2/expression/evaluate instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:15.298Z","updatedAt":"2026-10-23T10:32:15.298Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/post-rest-api-2-expression-eval-is-deprecated/"},{"slug":"post-rest-api-2-search-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"POST /rest/api/2/search is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["POST /rest/api/2/search"],"method":"POST","path":"/rest/api/2/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v2/api-group-issue-search/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call POST /rest/api/2/search/jql: it pages with nextPageToken instead of startAt and returns only ids unless fields are requested.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:11.529Z","updatedAt":"2026-10-23T10:32:11.529Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/post-rest-api-2-search-is-deprecated/"},{"slug":"post-rest-api-3-expression-eval-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"POST /rest/api/3/expression/eval is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["POST /rest/api/3/expression/eval"],"method":"POST","path":"/rest/api/3/expression/eval","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-jira-expressions/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call POST /rest/api/3/expression/evaluate instead.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:15.298Z","updatedAt":"2026-10-23T10:32:15.298Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/post-rest-api-3-expression-eval-is-deprecated/"},{"slug":"post-rest-api-3-search-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"POST /rest/api/3/search is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["POST /rest/api/3/search"],"method":"POST","path":"/rest/api/3/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call POST /rest/api/3/search/jql: it pages with nextPageToken instead of startAt and returns only ids unless fields are requested.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:03.961Z","updatedAt":"2026-10-23T10:32:03.961Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/post-rest-api-3-search-is-deprecated/"},{"slug":"post-rest-api-latest-search-is-deprecated","api":"jira-and-confluence-cloud-rest-apis","title":"POST /rest/api/latest/search is deprecated","kind":"removal","outcome":"fails","model":null,"announcedAt":"2024-10-31","effectiveAt":null,"scope":null,"calls":["POST /rest/api/latest/search"],"method":"POST","path":"/rest/api/latest/search","source":{"url":"https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/","kind":"archive"},"quote":"Endpoint is currently being removed.","migration":"Call POST /rest/api/latest/search/jql: it pages with nextPageToken instead of startAt and returns only ids unless fields are requested.","migrationChange":null,"needsDecision":null,"text":null,"publishedAt":"2026-10-23T10:32:03.961Z","updatedAt":"2026-10-23T10:32:03.961Z","status":"deprecated","tone":"deprecated","url":"https://www.okapi.bot/providers/jira-and-confluence-cloud-rest-apis/breaking-changes/post-rest-api-latest-search-is-deprecated/"}]}