ruby-jira 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a560af049fc2790fd46fcfa42a8913ff6a3e35fb6da619d0dbee7873a872fdec
-  data.tar.gz: d5e1af098eac6a126ca0643545effb8c9f420ef30349c716d127d7018ff3e8c5
+  metadata.gz: b943c4b2403edafbd328b20a1d6dc77378a9da1c760fad052df79b06e6af64d9
+  data.tar.gz: 9919c24e5dfecfb5cb5f5ec422cb9361fb50960f0cd25b2586924590b3d5facd
 SHA512:
-  metadata.gz: c144da359a042b32d600661c40eb4d8588eac575ded10b1a00cec642958631fe50a878f240a97c2d8e6220824aa49973f49103fa1e4cac0f0774f6f39d754886
-  data.tar.gz: 15b14457c90a78271c0af4644276d945dd3cea0d980919967f24081d11a53b5b0b8a710204aeaa71757c68b89798a63d5f83ca3301543d79e3f2e9d02d8f92d5
+  metadata.gz: 8c0a1e01394b98162692dc8da79d96dd232e2e0474d40fd4f1fd7d11d237dee99060e79939d67f1d709fec87df9f45d007fb38cc0d58f3353e54986aafd66a96
+  data.tar.gz: 87cead95e1bb42f69e20ea8a8bac887bd6e40b233d45e8a2b08a65a199925398f8c910b91ff1adac2f4342acea01c5d5e3fd2a08d1cde63d0f6d58d4a8e0a177

data/CHANGELOG.md

@@ -5,10 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-03-14
+
+### Added
+
+- Add time tracking api (#8) ([836bc35](https://github.com/macio/ruby-jira/commit/836bc35ba53369acf683bf3c18424816b9aecf8e))
+- Add project properties client (#6) ([db8796f](https://github.com/macio/ruby-jira/commit/db8796fcc59f34d91b5e9835730581ff9599fb5b))
+
 ## [0.1.0] - 2026-03-09
 
 ### Added
 
 - Add initial ruby-jira Jira API client gem ([09c7c53](https://github.com/macio/ruby-jira/commit/09c7c5302cec9ccd079d85f0c46466f53775e9da))
 
+[0.2.0]: https://github.com/macio/ruby-jira/compare/v0.1.0...v0.2.0
 

data/README.md

@@ -39,7 +39,7 @@ JIRA_EMAIL=you@example.com
 JIRA_API_TOKEN=your-api-token
 ```
 
-### OAuth 2.0 — pre-fetched access token
+### OAuth 2.0 - pre-fetched access token
 
 ```ruby
 Jira.configure do |config|
@@ -50,7 +50,7 @@ Jira.configure do |config|
 end
 ```
 
-### OAuth 2.0 — automatic token refresh (`refresh_token` grant)
+### OAuth 2.0 - automatic token refresh (`refresh_token` grant)
 
 ```ruby
 Jira.configure do |config|
@@ -64,7 +64,7 @@ Jira.configure do |config|
 end
 ```
 
-### OAuth 2.0 — service account (`client_credentials` grant)
+### OAuth 2.0 - service account (`client_credentials` grant)
 
 ```ruby
 Jira.configure do |config|
@@ -162,29 +162,39 @@ Jira.assign_permission_scheme("TEST", scheme_id: 101)
 
 ### Pagination
 
-Offset-paginated responses (`GET /project/search`, `GET /workflow/search`, etc.) return `Jira::PaginatedResponse`:
+Jira Cloud uses multiple pagination shapes across endpoints. This gem unifies them with `auto_paginate`, `each_page`,
+and `paginate_with_limit`.
+
+Offset-paginated responses return `Jira::PaginatedResponse` - includes `GET /project/search`, `GET /issue/{key}/comment`,
+`GET /issue/{key}/worklog`, and others:
 
 ```ruby
 page = Jira.projects
-page.total        # total count
-page.start_at     # current offset
-page.max_results  # page size
-page.last_page?   # isLast flag
+page.total          # total count
+page.start_at       # current offset
+page.max_results    # page size
+page.last_page?     # isLast flag
 page.next_page?
-page.next_page    # fetches the next page
-page.auto_paginate                # fetches all pages, returns flat Array
+page.next_page      # fetches the next page
+page.auto_paginate  # fetches all pages, returns flat Array
 page.paginate_with_limit(200)
 page.each_page { |p| process(p) }
 ```
 
-Cursor-paginated responses (`POST /search/jql`, etc.) return `Jira::CursorPaginatedResponse`:
+Cursor-paginated responses (`GET /search/jql`, `POST /search/jql`) return `Jira::CursorPaginatedResponse`:
 
 ```ruby
-results = Jira.search_issues(jql: "project = TEST ORDER BY created DESC")
+# GET /search/jql returns minimal issue payload by default (id only).
+# Pass fields/expand to fetch richer issue data.
+results = Jira.search_issues_jql(
+  jql: "project = TEST ORDER BY created DESC",
+  fields: "key,summary"
+)
 results.next_page_token   # raw token
 results.next_page?
 results.next_page         # fetches next page automatically
 results.auto_paginate     # fetches all pages
+results.paginate_with_limit(200)
 ```
 
 ### Rate limiting
@@ -202,7 +212,7 @@ The client automatically retries `429 Too Many Requests` and `503 Service Unavai
 | `X-RateLimit-Reset`     | ISO 8601 timestamp | When the rate-limit window resets (429 only)                                   |
 | `X-RateLimit-Limit`     | integer            | Max request rate for the current scope                                         |
 | `X-RateLimit-Remaining` | integer            | Remaining capacity in the current window                                       |
-| `X-RateLimit-NearLimit` | `"true"`           | Signals < 20% capacity remains — consider throttling proactively               |
+| `X-RateLimit-NearLimit` | `"true"`           | Signals < 20% capacity remains - consider throttling proactively               |
 | `RateLimit-Reason`      | string             | Which limit was exceeded (`jira-burst-based`, `jira-quota-tenant-based`, etc.) |
 
 **Retry strategy:** exponential backoff with proportional jitter (`delay × rand(0.7..1.3)`), respecting `Retry-After` and `X-RateLimit-Reset` headers. Falls back to backoff when no header is present.
@@ -217,6 +227,30 @@ Jira.configure do |config|
 end
 ```
 
+### Logging
+
+Pass any `Logger`-compatible object to enable debug logging. All requests, detected response types, and rate-limit retries are logged at `DEBUG` level.
+
+```ruby
+require "logger"
+
+Jira.configure do |config|
+  config.logger = Logger.new($stdout)
+end
+```
+
+Sample output:
+
+```
+GET /project/search {query: {maxResults: 50}}
+→ Jira::PaginatedResponse
+GET /search/jql {query: {jql: "project=TEST", nextPageToken: "..."}}
+→ Jira::CursorPaginatedResponse
+rate limited (HTTP 429), retrying in 5.0s (3 retries left)
+```
+
+Logging is disabled by default (`config.logger = nil`).
+
 ### Proxy
 
 ```ruby
@@ -241,16 +275,17 @@ Jira.http_proxy("proxy.example.com", 8080, "user", "pass")
 | `ratelimit_retries`    | `JIRA_RATELIMIT_RETRIES`    | `4`                                      |
 | `ratelimit_base_delay` | `JIRA_RATELIMIT_BASE_DELAY` | `2.0`                                    |
 | `ratelimit_max_delay`  | `JIRA_RATELIMIT_MAX_DELAY`  | `30.0`                                   |
+| `logger`               | —                           | `nil`                                    |
 
 ## Error handling
 
 ```ruby
-rescue Jira::Error::Unauthorized   # 401
-rescue Jira::Error::Forbidden      # 403
-rescue Jira::Error::NotFound       # 404
+rescue Jira::Error::Unauthorized    # 401
+rescue Jira::Error::Forbidden       # 403
+rescue Jira::Error::NotFound        # 404
 rescue Jira::Error::TooManyRequests # 429
-rescue Jira::Error::ResponseError  # any other 4xx/5xx
-rescue Jira::Error::Base           # all gem errors
+rescue Jira::Error::ResponseError   # any other 4xx/5xx
+rescue Jira::Error::Base            # all gem errors
 ```
 
 `Jira::Error::ResponseError` exposes:

data/lib/jira/client/issue_comments.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+module Jira
+  class Client
+    # Defines methods related to issue comments.
+    #
+    # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/
+    module IssueComments
+      # Returns a paginated list of comments specified by a list of comment IDs
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-comment-list-post
+      #
+      # @param payload [Hash] Payload with comment IDs (e.g. { ids: [1, 2, 3] })
+      # @param options [Hash] Query parameters (e.g. expand:)
+      # @return [Jira::PaginatedResponse]
+      def comments_by_ids(payload = {}, options = {})
+        post("/comment/list", body: payload, query: options)
+      end
+
+      # Returns all comments for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param options [Hash] Query parameters (e.g. startAt:, maxResults:, orderBy:, expand:)
+      # @return [Jira::PaginatedResponse]
+      def issue_comments(issue_id_or_key, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/comment", query: options)
+      end
+
+      # Adds a comment to an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Comment payload
+      # @param options [Hash] Query parameters (e.g. expand:)
+      # @return [Hash]
+      def add_comment(issue_id_or_key, payload = {}, options = {})
+        post("/issue/#{url_encode(issue_id_or_key)}/comment", body: payload, query: options)
+      end
+
+      # Returns a single comment for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-id-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param comment_id [Integer, String] The ID of the comment
+      # @param options [Hash] Query parameters
+      # @return [Hash]
+      def issue_comment(issue_id_or_key, comment_id, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/comment/#{comment_id}", query: options)
+      end
+
+      # Updates a comment on an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-id-put
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param comment_id [Integer, String] The ID of the comment
+      # @param payload [Hash] Comment payload
+      # @param options [Hash] Query parameters (e.g. expand:)
+      # @return [Hash]
+      def update_comment(issue_id_or_key, comment_id, payload = {}, options = {})
+        put("/issue/#{url_encode(issue_id_or_key)}/comment/#{comment_id}", body: payload, query: options)
+      end
+
+      # Deletes a comment from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-comments/#api-rest-api-3-issue-issueidorkey-comment-id-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param comment_id [Integer, String] The ID of the comment
+      # @return [nil]
+      def delete_comment(issue_id_or_key, comment_id)
+        delete("/issue/#{url_encode(issue_id_or_key)}/comment/#{comment_id}")
+      end
+    end
+  end
+end

data/lib/jira/client/issue_search.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module Jira
+  class Client
+    # Defines methods related to issue search.
+    #
+    # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/
+    module IssueSearch
+      # Returns issue suggestions for auto-completion based on a query string
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-issue-picker-get
+      #
+      # @param options [Hash] Query parameters (e.g. query:, currentJQL:, currentIssueKey:)
+      # @return [Hash]
+      def issue_picker(options = {})
+        get("/issue/picker", query: options)
+      end
+
+      # Checks whether one or more issues would be returned by a JQL query
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-jql-match-post
+      #
+      # @param payload [Hash] Payload with JQL queries and issue IDs to match
+      # @return [Hash]
+      def match_issues(payload = {})
+        post("/jql/match", body: payload)
+      end
+
+      # Returns an approximate count of issues matching a JQL query
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-approximate-count-post
+      #
+      # @param payload [Hash] Payload with JQL query (e.g. { jql: "project = EX" })
+      # @return [Hash]
+      def approximate_issue_count(payload = {})
+        post("/search/approximate-count", body: payload)
+      end
+
+      # Searches for issues using JQL with reconciliation (GET)
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-jql-get
+      #
+      # @param options [Hash] Query parameters (e.g. jql:, nextPageToken:, maxResults:, fields:)
+      # @return [Jira::CursorPaginatedResponse]
+      def search_issues_jql(options = {})
+        get("/search/jql", query: options)
+      end
+
+      # Searches for issues using JQL with reconciliation (POST)
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-search/#api-rest-api-3-search-jql-post
+      #
+      # @param payload [Hash] Search payload (e.g. jql:, nextPageToken:, maxResults:, fields:)
+      # @return [Jira::CursorPaginatedResponse]
+      def search_issues_jql_post(payload = {})
+        post("/search/jql", body: payload)
+      end
+    end
+  end
+end

data/lib/jira/client/issue_worklogs.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+module Jira
+  class Client
+    # Defines methods related to issue worklogs.
+    #
+    # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/
+    module IssueWorklogs
+      # Returns worklogs for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param options [Hash] Query parameters
+      # @return [Jira::PaginatedResponse]
+      def issue_worklogs(issue_id_or_key, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/worklog", query: options)
+      end
+
+      # Adds a worklog to an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Worklog payload
+      # @param options [Hash] Query parameters
+      # @return [Hash]
+      def add_worklog(issue_id_or_key, payload = {}, options = {})
+        post("/issue/#{url_encode(issue_id_or_key)}/worklog", body: payload, query: options)
+      end
+
+      # Bulk deletes worklogs from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Worklog IDs payload
+      # @return [nil]
+      def bulk_delete_worklogs(issue_id_or_key, payload = {})
+        delete("/issue/#{url_encode(issue_id_or_key)}/worklog", body: payload)
+      end
+
+      # Bulk moves worklogs from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-move-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Move worklogs payload
+      # @return [nil]
+      def bulk_move_worklogs(issue_id_or_key, payload = {})
+        post("/issue/#{url_encode(issue_id_or_key)}/worklog/move", body: payload)
+      end
+
+      # Returns a single worklog for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-id-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param worklog_id [Integer, String] The ID of the worklog
+      # @param options [Hash] Query parameters
+      # @return [Hash]
+      def worklog(issue_id_or_key, worklog_id, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/worklog/#{worklog_id}", query: options)
+      end
+
+      # Updates a worklog on an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-id-put
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param worklog_id [Integer, String] The ID of the worklog
+      # @param payload [Hash] Worklog payload
+      # @param options [Hash] Query parameters
+      # @return [Hash]
+      def update_worklog(issue_id_or_key, worklog_id, payload = {}, options = {})
+        put("/issue/#{url_encode(issue_id_or_key)}/worklog/#{worklog_id}", body: payload, query: options)
+      end
+
+      # Deletes a worklog from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-issue-issueidorkey-worklog-id-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param worklog_id [Integer, String] The ID of the worklog
+      # @param options [Hash] Query parameters
+      # @return [nil]
+      def delete_worklog(issue_id_or_key, worklog_id, options = {})
+        delete("/issue/#{url_encode(issue_id_or_key)}/worklog/#{worklog_id}", query: options)
+      end
+
+      # Returns IDs of worklogs deleted since a given time
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-worklog-deleted-get
+      #
+      # @param options [Hash] Query parameters (e.g. since:)
+      # @return [Jira::CursorPaginatedResponse]
+      def deleted_worklog_ids(options = {})
+        get("/worklog/deleted", query: options)
+      end
+
+      # Returns worklogs for a list of IDs
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-worklog-list-post
+      #
+      # @param payload [Hash] Worklog IDs payload
+      # @param options [Hash] Query parameters
+      # @return [Array<Hash>]
+      def worklogs_for_ids(payload = {}, options = {})
+        post("/worklog/list", body: payload, query: options)
+      end
+
+      # Returns IDs of worklogs updated since a given time
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issue-worklogs/#api-rest-api-3-worklog-updated-get
+      #
+      # @param options [Hash] Query parameters (e.g. since:)
+      # @return [Jira::CursorPaginatedResponse]
+      def updated_worklog_ids(options = {})
+        get("/worklog/updated", query: options)
+      end
+    end
+  end
+end

data/lib/jira/client/issues.rb

@@ -3,17 +3,33 @@
 module Jira
   class Client
     # Defines methods related to issues.
+    #
+    # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/
     module Issues
       # Creates a new issue
       #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post
+      #
       # @param payload [Hash] Issue payload
       # @return [Hash]
       def create_issue(payload = {})
         post("/issue", body: payload)
       end
 
+      # Creates multiple issues in a single request
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-bulk-post
+      #
+      # @param payload [Hash] Bulk issue creation payload
+      # @return [Hash]
+      def bulk_create_issues(payload = {})
+        post("/issue/bulk", body: payload)
+      end
+
       # Gets a single issue
       #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-get
+      #
       # @param issue_id_or_key [Integer, String] The ID or key of an issue
       # @param options [Hash] Query parameters
       # @return [Hash]
@@ -23,6 +39,8 @@ module Jira
 
       # Updates an existing issue
       #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-put
+      #
       # @param issue_id_or_key [Integer, String] The ID or key of an issue
       # @param payload [Hash] Issue payload
       # @param options [Hash] Query parameters
@@ -30,6 +48,179 @@ module Jira
       def edit_issue(issue_id_or_key, payload = {}, options = {})
         put("/issue/#{url_encode(issue_id_or_key)}", body: payload, query: options)
       end
+
+      # Deletes an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param options [Hash] Query parameters (e.g. deleteSubtasks)
+      # @return [nil]
+      def delete_issue(issue_id_or_key, options = {})
+        delete("/issue/#{url_encode(issue_id_or_key)}", query: options)
+      end
+
+      # Assigns an issue to a user
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-assignee-put
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Assignee payload (e.g. { accountId: "..." })
+      # @return [nil]
+      def assign_issue(issue_id_or_key, payload = {})
+        put("/issue/#{url_encode(issue_id_or_key)}/assignee", body: payload)
+      end
+
+      # Returns a list of transitions for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param options [Hash] Query parameters
+      # @return [Hash]
+      def issue_transitions(issue_id_or_key, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/transitions", query: options)
+      end
+
+      # Performs a transition on an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-transitions-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Transition payload
+      # @return [nil]
+      def transition_issue(issue_id_or_key, payload = {})
+        post("/issue/#{url_encode(issue_id_or_key)}/transitions", body: payload)
+      end
+
+      # Returns paginated changelog for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-changelog-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param options [Hash] Query parameters
+      # @return [Jira::PaginatedResponse]
+      def issue_changelog(issue_id_or_key, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/changelog", query: options)
+      end
+
+      # Returns the watchers for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-watchers-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @return [Hash]
+      def issue_watchers(issue_id_or_key)
+        get("/issue/#{url_encode(issue_id_or_key)}/watchers")
+      end
+
+      # Adds a watcher to an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-watchers-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param account_id [String] The account ID of the user to watch the issue
+      # @return [nil]
+      def add_watcher(issue_id_or_key, account_id)
+        post("/issue/#{url_encode(issue_id_or_key)}/watchers", body: account_id)
+      end
+
+      # Removes a watcher from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-watchers-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param account_id [String] The account ID of the user to remove
+      # @return [nil]
+      def remove_watcher(issue_id_or_key, account_id:)
+        delete("/issue/#{url_encode(issue_id_or_key)}/watchers", query: { accountId: account_id })
+      end
+
+      # Returns vote information for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-votes-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @return [Hash]
+      def issue_votes(issue_id_or_key)
+        get("/issue/#{url_encode(issue_id_or_key)}/votes")
+      end
+
+      # Adds a vote to an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-votes-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @return [nil]
+      def add_vote(issue_id_or_key)
+        post("/issue/#{url_encode(issue_id_or_key)}/votes")
+      end
+
+      # Removes a vote from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-votes-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @return [nil]
+      def remove_vote(issue_id_or_key)
+        delete("/issue/#{url_encode(issue_id_or_key)}/votes")
+      end
+
+      # Returns remote links for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-remotelink-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param options [Hash] Query parameters
+      # @return [Array<Hash>]
+      def issue_remote_links(issue_id_or_key, options = {})
+        get("/issue/#{url_encode(issue_id_or_key)}/remotelink", query: options)
+      end
+
+      # Creates or updates a remote link for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-remotelink-post
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param payload [Hash] Remote link payload
+      # @return [Hash]
+      def create_or_update_remote_link(issue_id_or_key, payload = {})
+        post("/issue/#{url_encode(issue_id_or_key)}/remotelink", body: payload)
+      end
+
+      # Returns a single remote link for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-remotelink-linkid-get
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param link_id [Integer, String] The ID of the remote link
+      # @return [Hash]
+      def remote_link(issue_id_or_key, link_id)
+        get("/issue/#{url_encode(issue_id_or_key)}/remotelink/#{link_id}")
+      end
+
+      # Updates a remote link for an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-remotelink-linkid-put
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param link_id [Integer, String] The ID of the remote link
+      # @param payload [Hash] Remote link payload
+      # @return [nil]
+      def update_remote_link(issue_id_or_key, link_id, payload = {})
+        put("/issue/#{url_encode(issue_id_or_key)}/remotelink/#{link_id}", body: payload)
+      end
+
+      # Deletes a remote link from an issue
+      #
+      # @url https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-issueidorkey-remotelink-linkid-delete
+      #
+      # @param issue_id_or_key [Integer, String] The ID or key of an issue
+      # @param link_id [Integer, String] The ID of the remote link
+      # @return [nil]
+      def delete_remote_link(issue_id_or_key, link_id)
+        delete("/issue/#{url_encode(issue_id_or_key)}/remotelink/#{link_id}")
+      end
     end
   end
 end