Skip to main content
Upsun Dispatch workflows that use OpenAI require an OpenAI model key for your organization. Store the key once at the organization level, then use workflow settings when a workflow or repository override should select that model integration.
Model keys belong to the organization, not to an individual repository, GitHub installation, or GitLab project. For default model integration selection and shared model-key settings, see AI models.

​
Store an OpenAI key

  1. Sign in to Upsun Dispatch and open the organization you want to configure.
  2. Open Settings > AI model keys.
  3. Select OpenAI.
  4. Select Add key.
  5. Enter the OpenAI API key in API key.
  6. Select Save.
After the key is stored, Upsun Dispatch can use it for workflows that select OpenAI. To choose OpenAI for a specific workflow or repository override, configure model selection in Workflows in Upsun Dispatch.

​
Check key status

Use the OpenAI row in AI keys settings to confirm whether an OpenAI key is stored and which key-management actions are available. If your organization also stores other model keys, use the AI keys settings to choose the default model integration. Upsun Dispatch uses that default unless a workflow setting or repository override selects a different model integration.

​
Rotate a key

To rotate the organization’s OpenAI key, return to the OpenAI row in AI keys settings and use the replace-key control. Store the new key in the same settings area. The new key replaces the previous OpenAI key for the organization.

​
Set an API base URL

AI keys settings include an optional API base URL setting for model integration configuration. Set an API base URL only when your organization has an OpenAI API base URL to use.

​
Remove a key

Remove the OpenAI key if the organization should no longer use it. Before removing the key, make sure workflows that should continue running are configured to use an available model key. You can change workflow-level model selection and repository overrides in Workflows in Upsun Dispatch.

​
Next steps

Configure workflow settings

Select the model integration Upsun Dispatch should use for workflows or repository overrides.

Learn about Code review

See how Upsun Dispatch reviews GitHub pull requests and GitLab merge requests.
Last modified on September 16, 2026