Skip to main content

changedBy

Overview​

The changedBy function allows you to search for issues where fields were updated within a given time period, optionally filtered by the user who made the updates. This is useful for tracking field changes, monitoring updates, and generating reports based on field modifications.

Syntax​

issue in changedBy("subquery", "fieldName", "start_date", "end_date", "user")

Parameters​

  • subquery (required): A valid JQL query that defines the set of issues to evaluate
  • fieldName (optional): The name of the field to check for updates. If empty, any field change will be matched
  • start_date (optional): The start date in format "yyyy/MM/dd HH:mm" or "yyyy/MM/dd", or a relative expression like -2w (see Relative date ranges)
  • end_date (optional): The end date in the same format as start_date
  • user (optional): The username or display name of the person who made the update

Supported Operators​

  • in - issues matching the criteria
  • not in - issues not matching the criteria

Examples​

Finding issues where any field was updated within a date range​

issue in changedBy("project = SER", "", "2023/01/01", "2023/05/01")

Finding issues where Description was updated within a date range​

issue in changedBy("project = SER", "Description", "2023/01/01", "2023/05/01")

Finding issues where Priority was updated by a specific user​

issue in changedBy("project = SER", "Priority", "2023/01/01", "2023/12/31", "jsmith")

Finding issues updated since a specific date​

issue in changedBy("project = SER", "", "2023/06/01 10:00")

Finding issues not updated by a specific user​

issue not in changedBy("project = SER", "", "2023/01/01", "2023/12/31", "jsmith")

Relative date ranges (self-updating)​

start_date and end_date also accept a relative expression — a leading - followed by a duration (w/d/h/m/s) — meaning "now minus that duration". Argon re-resolves the window every time the query runs (refreshed hourly), so these saved filters and dashboards never need editing.

-- Anything touched in the last week (a rolling "recently active" board)
issue in changedBy("project = SER", "", "-1w")

-- Priority changes in the last 3 days (triage review)
issue in changedBy("project = SER", "Priority", "-3d")

-- Fields a specific user changed in the last 14 days
issue in changedBy("project = SER", "", "-14d", "", "jsmith")

See Relative dates for the full format reference.

Performance Considerations​

  • The function analyzes all changelogs from issues matching the JQL subquery, which may take significant time to complete
  • Using specific date ranges can improve performance
  • Including a username filter can significantly reduce the number of issues to process

Error Handling​

The function will return an error if:

  • Invalid field names are specified
  • Invalid date formats (must be "yyyy/MM/dd HH:mm" or "yyyy/MM/dd")
  • Non-existent users are specified
  • Invalid JQL queries
  • transitionedBy - Search for issues transitioned to a specific status
  • commented - Search for issues with specific comment criteria