Connect a GitHub installation to the workspace

Owner or Admin connects once through one GitHub browser link. The original user session or user API key is bound to the thirty-minute authorization. Repeat the same request and key to observe its result. No provider credential is returned or retained.

post/v1/organizations/{organization_id}/github:connect

Request

  • Base URL: https://app.ohmyho.st
  • URL: https://app.ohmyho.st/v1/organizations/{organization_id}/github:connect
  • Auth: HTTP bearer

Path parameters

organization_idstring required

Headers

X-Request-Idstring

Optional caller-provided correlation identifier.

Idempotency-Keystring required

Identifies one mutation and its canonical request payload.

Request body

ConnectGithubOrganizationRequest required

Response

Bound authorization handoff, replay status, or the existing connection.

authorization_idstring nullable required
status'pending' | 'authorizing' | 'connected' | 'failed' | 'expired' required
last_failure'installation_access_required' | 'account_admin_required' | 'authorization_code_rejected' | 'provider_unavailable' | 'expired' | 'session_inactive' | 'denied' | 'code_spent' | 'state_unknown' | 'null' nullable required
authorization_urlstring uri nullable required

One GitHub browser authorization link when pending; contains only the bound single-use state, never a provider credential.

expires_atstring date-time nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.