Inquiry regarding undocumented 403 Forbidden error on /rest/api/3/project/search for 3LO App

[Buren Zhang]

Hi Jira Platform Team,

We’ve recently observed several instances where users are encountering a 403 Forbidden error when calling the following endpoint via our 3LO (OAuth 2.0) integration:

GET https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/project/search?expand=lead&startAt=0&maxResults=200&status=live&action=browse

Context:

• Our app has the read:project:jira scope configured and authorized.

• The official REST API documentation does not list 403 as a potential response code for this endpoint.

We would like to clarify:

1. Is this 403 error a result of a recent platform change or a specific security policy (e.g., granular scope enforcement)?

2. Is this an omission in the documentation, or is there a new requirement for additional scopes (such as read:user:jira due to the expand=lead parameter)?

Looking forward to your guidance on whether this is expected behavior or a potential regression.

Best regards,

[Marc -Devoteam-]

HI @Buren Zhang 

To use this call the user executing the call in the app, need to have the following permissions on a project to be shown as result on the API call

1. Browse permission
2. Admin permission

Overall the user also needs to be a Jira Administrator