Skip to main content
POST
Create Engine Picker Session Selection

Path Parameters

session_id
string
required

Body

application/json

Selection from a Forge GitHub App installation picker.

action
enum<string>
required

Whether to attach an installation or install the GitHub App.

Available options:
ATTACH,
INSTALL_NEW
installation_id
integer | null

GitHub installation ID required when action is ATTACH.

Response

Successful Response

Response for POST /forge/github/picker-session/{id}/select. The FE navigates the browser to redirect_url — that URL is either the FE result page (for "attach") or a github.com install picker (for "install_new"). Returning JSON instead of 302 keeps the FE's POST-as-API flow predictable and lets it surface errors before navigating.

redirect_url
string
required