Convert user identifiers to account IDs in JQL queries

POST

/rest/api/3/jql/pdcleaner

Converts one or more JQL queries with user identifiers (username or user key) to equivalent JQL queries with account IDs.

You may wish to use this operation if your system stores JQL queries and you want to make them GDPR-compliant. For more information about GDPR-related changes, see the migration guide.

Permissions required: Permission to access Jira.

Request

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful. Note that the JQL queries are returned in the same order that they were passed.

Body

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/jql/pdcleaner' \
--header 'Content-Type: application/json' \
--data-raw '{
    "queryStrings": [
        "assignee = mia",
        "issuetype = Bug AND assignee in (mia) AND reporter in (alana) order by lastViewed DESC"
    ]
}'

Response Example

200 - Success

{"queriesWithUnknownUsers":[{"convertedQuery":"assignee = unknown","originalQuery":"assignee = mia"}],"queryStrings":["issuetype = Bug AND assignee in (abcde-12345) AND reporter in (abc551-c4e99) order by lastViewed DESC"]}

Modified at 2025-07-16 07:18:01

Parse JQL query

Sanitize JQL queries