Get GitHub organization policy

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Tells you whether the app's workspace limits GitHub repositories to an approved list of organizations.

When restricted is true, List GitHub organizations returns only approved organizations, and Connect a GitHub repository answers 403 for any other owner. The approved list itself is managed in workspace settings and is not part of this API.

Workspace owners and admins can connect under any organization while the limit is on, but the organization list they read is filtered the same way, so restricted is true for them too.

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

get/api/apps/{app_id}/github/org-policy

Path parameters

app_idstring required

ID of the app whose workspace decides which GitHub organizations you can use.

ID of the app whose workspace decides which GitHub organizations you can use.

Response

Whether the workspace limits which GitHub organizations you can use.

restrictedboolean required

true when the app's workspace limits GitHub repositories to an approved list of organizations.

Changes