ATatlassian
JQL

Parse JQL query

Changed on

Parses and validates JQL queries.

Validation is performed in context of the current user.

This operation can be accessed anonymously.

Permissions required: None.

post/rest/api/3/jql/parse

Request

  • Base URL
    https://your-domain.atlassian.net
  • URL
    https://your-domain.atlassian.net/rest/api/3/jql/parse
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: read:jira-work
    • or none

Query parameters

validation'strict' | 'warn' | 'none' required

How to validate the JQL query and treat the validation results. Validation options include:

  • strict Returns all errors. If validation fails, the query structure is not returned.
  • warn Returns all errors. If validation fails but the JQL query is correctly formed, the query structure is returned.
  • none No validation is performed. If JQL query is correctly formed, the query structure is returned.

Request body

queriesstring[] required

A list of queries to parse.

Response

Returned if the request is successful.

Changes