Get Started with Upsun Dispatch

Set up Upsun Dispatch by creating or joining an organization, inviting the people who need access, connecting GitHub or GitLab, and storing an AI model key for workflow runs. For the shortest path to your first review, follow the Quickstart. This page explains the onboarding pieces and links to detailed setup guides.

​

What you can do with Upsun Dispatch

Use Upsun Dispatch to:

• Request implementation work from supported issue systems and let Upsun Dispatch open or update a pull or merge request.
• Review code changes on GitHub pull requests and GitLab merge requests.
• Monitor workflow runs with status, step details, timelines, logs, related source entities, and usage.
• Manage organization access with members, roles, and invitations.
• Configure workflow behavior at the organization level and with repository-specific overrides.
• Review token usage by model or workflow over time.

​

Core concepts

​

Organizations

An organization contains the integrations, model keys, repositories, members, workflow settings, runs, and usage data that belong together. When you create an organization, you become its owner. Owners and admins can manage settings, members, and invitations from the Upsun Dispatch console.

​

Code integrations

Upsun Dispatch connects to your repositories through code integrations:

• GitHub uses the Upsun Dispatch GitHub App.
• GitLab uses organization-scoped service accounts and connected projects.

For setup details, see Integrations, Set up GitHub, and Set up GitLab.

​

AI model keys

Upsun Dispatch workflows require at least one organization-scoped AI model key. You can store keys for Anthropic, OpenAI, or both, then choose the default key Upsun Dispatch uses for runs. After a key is stored, Upsun Dispatch shows only key metadata such as whether the key is set, the last four characters, and set or tested timestamps. See AI models for model key setup, rotation, removal, default key selection, and API base URL settings.

​

Built-in workflows

Upsun Dispatch includes built-in workflows for common development tasks:

• Issue to code starts from supported issue systems: GitHub Issues, Jira issues, and Linear issues. The entire issue body or a single comment must be exactly @upsun-dispatch implement; an optional trailing !, ., or ? is allowed. Upsun Dispatch then plans the work and opens or updates a pull or merge request when it can complete the request. See Issue to code.
• Code review reviews GitHub pull requests and GitLab merge requests. It can start automatically from supported code events or manually from supported comment commands. See Code review.

For a higher-level workflow overview, see Workflows in Upsun Dispatch and Built-in workflows.

​

Runs, logs, and usage

Every workflow execution appears as a run in the Upsun Dispatch console. Run detail shows status, step attempts, timeline events, capped log excerpts, and usage information. You can also open full or live logs for individual jobs and rerun eligible terminal runs. Usage reports aggregate token usage across run step attempts and can be grouped by model or workflow. See Use the Upsun Dispatch console for console tasks.

​

How Upsun Dispatch fits into your workflow

1. You connect GitHub or GitLab to an organization.
2. You store at least one organization AI model key and choose the default key.
3. Upsun Dispatch receives supported code events or supported manual requests.
4. A built-in workflow runs and records progress in the console.
5. Upsun Dispatch publishes results back to GitHub or GitLab when the workflow produces review output or opens a pull or merge request.

​

Before you begin

You need:

• An Upsun account you can use to sign in to Upsun Dispatch.
• Permission to create or manage the Upsun Dispatch organization you want to use.
• Access to the code integration you want to connect:
  • GitHub App installation access for GitHub repositories.
  • GitLab project and service-account credential access for GitLab merge request review.
• An Anthropic or OpenAI API key for the organization.

​

1. Sign in

Sign in with Upsun Auth. Upsun Dispatch redirects you to complete authentication in your browser, then returns you to Upsun Dispatch with a browser session for your user account, primary email address, and available organizations. If Upsun Dispatch asks you to complete welcome or terms prompts, complete them before continuing.

​

2. Create or choose an organization

Create a Upsun Dispatch organization for the company, department, or group that owns integrations, repositories, workflow settings, members, and model keys. The user who creates an organization becomes its owner. If you were invited to an existing organization, sign in with the email address that received the invitation, then accept the pending invitation shown for your account. Organizations are the main boundary for Upsun Dispatch access:

• You only see organizations where you are a member.
• Organization owners and admins can update organization details and manage access.
• Upsun Dispatch protects organizations from being left without an owner.

For ongoing organization management in the web console, see Use the Upsun Dispatch console.

​

3. Invite members

Owners and admins can invite people to join an organization as admins or members. Invitations are sent to an email address, and the invited person must sign in with that same email address to accept. Invitation roles support admin or member only. Ownership is established when a user creates the organization or by changing a member’s role after they join. For ongoing access management, see Manage members and invitations. Owners and admins can also resend or revoke pending invitations, change member roles, and remove members from the organization.

​

4. Connect GitHub or GitLab

Connect at least one code integration so Upsun Dispatch can receive repository events and publish workflow results back to your code host. Integrations belong to the organization. For example, an organization can link one or more GitHub App installations. Disconnecting a GitHub installation from Upsun Dispatch does not uninstall the GitHub App from GitHub. For a single place to manage connected GitHub and GitLab access, ignored automation authors, and repository visibility, see Integrations.

​

5. Store an AI model key

Store an Anthropic or OpenAI key for the organization so workflow runs can use it. An organization can store keys for multiple AI model integrations and choose one default key for runs. After a key is stored, Upsun Dispatch never shows the full key value again. The console shows only metadata, such as whether a key is set, the last four characters, and when it was set or tested. Continue with AI models, Store your Anthropic key, or Store your OpenAI key.

​

6. Run your first workflow

After you connect GitHub or GitLab and store a model key, run one of the built-in workflows.

• Use the Quickstart to trigger your first code review from a pull request or merge request.
• Read Built-in workflows to understand the available workflow types.
• Use Workflows in Upsun Dispatch to learn how organization and repository settings control workflow behavior.

​

Next steps