permissions_query_syntax_error

{
  "meta": {
    "requestId": "req_2c9a0jf23l4k567"
  },
  "error": {
    "detail": "Missing closing parenthesis ')' at position 24. Every opening parenthesis must have a matching closing parenthesis.",
    "status": 400,
    "title": "Bad Request",
    "type": "/errors/user/bad_request/permissions_query_syntax_error",
    "errors": []
  }
}

​

Likely causes

• You wrote && or || instead of AND or OR.
• You put quotes around slugs.
• A ( has no matching ), or a group is empty: ().
• A slug has a character outside the allowed set: letters, numbers, dots, underscores, hyphens, slashes, colons, asterisks, and parentheses.
• A token is where an operator or slug was expected, or the query is blank.

​

How to fix

1. Fix the query at the position named in detail.
2. Write it as slugs joined with AND and OR, grouped with parentheses. For example: documents.read AND (billing.read OR billing.write).
3. If you build the query from user input, validate it first. A syntax error fails the whole request instead of returning valid: false.

​

Related errors

• err:unkey:authorization:insufficient_permissions: the query parsed but your root key lacks a permission the endpoint needs.
• err:unkey:application:invalid_input: another field of the request failed validation.