Connections
Save model-provider and repository credentials, then choose which runs can use them.
Save a connection
Open Connections in your organization. It lists your personal connections and the org's together, each marked Personal or Org. Choose New connection, pick what you are connecting, then choose Personal for your own credentials or Org for credentials shared with members. Owners and admins manage Org connections; saved values cannot be read back in the console.
Select a provider and save its required fields. A profile declares the connection names and fields its agents need. For user-started runs, complete values from the invoking process take priority, followed by personal connections, then Org connections. Partial explicit values fail rather than borrowing missing fields. Organization automation uses Org connections only. When you have a personal connection with the same name as an Org one, the list marks the Org one “Overridden by personal”.
Each connection has its own page: its status, its fields, what needs it, and Replace and Delete.
OpenAI, Anthropic, OpenRouter | Save the provider API key. Platform checks the key. |
|---|---|
Amazon Bedrock | Save a Bedrock API key and AWS region together. Platform checks them. |
Microsoft Foundry | Save the API key and resource name. Models use your deployment names. |
Gateway | Save its HTTPS endpoint and API key. Codex uses Responses; Claude Code uses Messages. |
Decision Provider | Save the full System One endpoint and key. Choose its model in the profile. |
Foundry, Gateway, and Decision Provider show Configured after saving; the run checks them when used. For gateway protocols, field names, and supported provider pairs, use the Zeroshot connection reference. See the Tailscale gateway guide for network requirements.
Connect GitHub
On Connections, choose New connection, then GitHub and Personal, then Connect your GitHub account and approve Zeroshot Repository Access. This uses your repository grants and works without an App installation. Platform sign-in and your local gh login do not supply this connection.
Alternatively, choose Use a personal access token. Code delivery needs Contents and Pull requests read/write; issue comments need Issues read/write. GitHub organization approval and SSO policies still apply. Saving a PAT replaces the current personal connection. For Copilot's GitHub runtime, use OAuth or a fine-grained personal PAT with Copilot Requests permission and a Copilot entitlement; classic PATs cannot authenticate it.
Organization GitHub access always uses the GitHub App. For shared GitHub comment automation, an owner or admin chooses GitHub and Org, then Install App, approves installation, and selects repositories. Personal access tokens are available only as personal connections. Installing the App does not replace the personal connection. Runs and preparation scripts inherit the repositories and permissions granted to the selected connection.
Custom connections and allowed destinations
Choose New connection, then Custom. Name it and add its field names and values. Put nonsecret configuration in environment variables.
Allowed destinations optionally restricts custom credentials to up to sixteen HTTPS origins, one per line: for example, https://api.example.com. A port is allowed; paths, queries, and embedded credentials are not. This is connection metadata, so it does not belong in scripts or a node's environment-field declaration.
To change them later, open the connection and choose Change destinations. Destinations are saved with the values, so you enter the values again; no one can send a saved secret somewhere new without knowing it. Replace changes only the values and keeps the destinations.
Provider credentials automatically bind to their configured endpoint or provider defaults; the custom list cannot broaden that binding. The proxy does not change provider permissions, and approved services can return sensitive tokens. SSH private keys and AWS signing credentials are unsupported while credential egress is enabled.
A saved GIT_PASSWORD, GH_TOKEN, GITHUB_TOKEN or GITLAB_TOKEN is sent only to its connection's allowed destinations, never to a host a run names. With the list blank, a GitHub or GitLab token goes only to GitHub.com or GitLab.com, and a Git password cannot be used until you add its Git host.
Credential destinations and allowed network hosts are separate. Both must permit the request. Allowing a host never authorizes a credential there.
Replace or disconnect
Replace the complete set of fields when updating a connection. Queued runs retain the values and destinations captured at acceptance; resumed attempts resolve them again. Managed GitHub credentials can refresh during a run. Disconnecting a connection does not stop accepted work; use Stop when needed.