Connect GitHub

Create the connection

Open Connections, choose GitHub, and select the organization and repositories the workflow needs. Compaos requests repository-level access; you can change the selection later in GitHub settings.

Use the connection

Reference the connection by its project alias. Secrets and provider tokens are resolved at runtime and are never exposed to workflow code.

const issue = await github.issues.create({
  connection: 'product-github',
  owner: 'acme',
  repo: 'roadmap',
  title: input.title,
  body: input.summary,
});

Handle provider limits

GitHub rate-limit responses are retried using the reset time provided by the API. Keep bulk operations bounded and prefer webhook-triggered workflows over polling.

Revoke access

Disconnecting GitHub prevents new calls immediately. Existing run records retain non-secret request metadata for auditing.