v1

latestOpenAPI 3.0.3Apache 2.02026-07-142201861.5 MB
Events

Bulk Mutate an Organization's Issues

Bulk mutate various attributes on a maxmimum of 1000 issues.

  • For non-status updates, the id query parameter is required.
  • For status updates, the id query parameter may be omitted to update issues that match the filtering. If any IDs are out of scope, the data won't be mutated but the endpoint will still produce a successful response. For example, if no issues were found matching the criteria, a HTTP 204 is returned.
put/api/0/organizations/{organization_id_or_slug}/issues/

Path parameters

organization_id_or_slugstring required

The ID or slug of the organization the resource belongs to.

Query parameters

environmentstring[]

The name of environments to filter by.

The IDs or slugs of projects to filter by. Project slugs are unique within each organization. Omit this parameter to include all accessible projects. -1 is also accepted to include all accessible projects. For example, the following are valid parameters:

  • /?project=1234&project=56789
  • /?project=android&project=javascript-react
  • /?project=-1
idinteger[]

The list of issue IDs to mutate. It is optional for status updates, in which an implicit update all is assumed.

querystring

An optional search query for filtering issues. A default query will apply if no view/query is set. For all results use this parameter with an empty string.

viewIdstring

The ID of the view to use. If no query is present, the view's query and filters will be applied.

sort'date' | 'freq' | 'inbox' | 'new' | 'recommended' | 'trends' | 'user'

The sort order of the view. Options include 'Last Seen' (date), 'First Seen' (new), 'Trends' (trends), 'Events' (freq), 'Users' (user), 'Date Added' (inbox), and 'Recommended' (recommended).

limitinteger

The maximum number of issues to affect. The maximum is 100.

Request body

inboxboolean required

If true, marks the issue as reviewed by the requestor.

status'resolved' | 'unresolved' | 'ignored' | 'resolvedInNextRelease' | 'muted' required

Limit mutations to only issues with the given status.

  • resolved
  • unresolved
  • ignored
  • resolvedInNextRelease
  • muted
substatus'archived_until_escalating' | 'archived_until_condition_met' | 'archived_forever' | 'escalating' | 'ongoing' | 'regressed' | 'new' | 'null' nullable required

The new substatus of the issue.

  • archived_until_escalating
  • archived_until_condition_met
  • archived_forever
  • escalating
  • ongoing
  • regressed
  • new
hasSeenboolean required

If true, marks the issue as seen by the requestor.

isBookmarkedboolean required

If true, bookmarks the issue for the requestor.

isPublicboolean required

If true, publishes the issue.

isSubscribedboolean required

If true, subscribes the requestor to the issue.

mergeboolean required

If true, merges the issues together.

discardboolean required

If true, discards the issues instead of updating them.

assignedTostring required

The user or team that should be assigned to the issues. Values take the form of <user_id>, user:<user_id>, <username>, <user_primary_email>, or team:<team_id>.

priority'low' | 'medium' | 'high' required

The priority that should be set for the issues

  • low
  • medium
  • high

Response

discardboolean
hasSeenboolean
inboxboolean
isBookmarkedboolean
isPublicboolean
isSubscribedboolean
prioritystring
shareIdstring
statusstring
substatusstring