- assign the pull or merge request that Issue to code opens to you, the person who started the run, and
- record you as the person who started each run.
Which accounts to connect
To assign a pull or merge request to you, Upsun Dispatch needs your account on the tool where you started the run and on the host where the pull or merge request opens.
If an account is missing, Upsun Dispatch opens the pull or merge request with no assignee.
For a run started on Jira or Linear, Upsun Dispatch sets an assignee only when the repository or project is private. An assignee would show who asked for the work, so a public repository, or a GitLab project with internal visibility, gets no assignee.
Connect an account
You connect GitHub, GitLab, Bitbucket, Jira, and Linear accounts with a one-time code. You post the code as a comment from the account you want to connect, then confirm it on your profile.1
Open your profile
In the Upsun Dispatch console, open the account menu and select My profile. Find the Connected accounts card.
2
Get a one-time code
Select Connect an account, then choose the provider. For GitLab, choose the instance. For Linear, choose the workspace. The list shows only the connections of your organizations. Select Get code.The card shows the code and the exact comment to post. The code expires in 10 minutes.
3
Post the comment
Signed in to the account you want to connect, post the comment the card shows:
On Linear, type
@ and pick the Upsun Dispatch app from the mention list, then paste the rest of the comment. A typed or pasted name is not a mention, so Linear does not send the comment to Upsun Dispatch.Upsun Dispatch replies to your comment and asks you to confirm the account on your profile.4
Confirm the account
On your profile, the Waiting for confirmation section shows the account that posted your code. If the account is yours, select Confirm. If it is not, select Reject. You have 10 minutes to confirm.The account then shows in the Connected accounts list.
Anyone who sees your code can post it. The comment alone does not connect an account: only you can confirm it on your profile. If two different accounts post the same code, the code stops working. Get a new code and post it again.
Permissions on the provider
To post the code, the account needs this access:- GitLab: the Developer role or higher on the project.
- GitHub and Bitbucket: write access to the repository.
- Jira and Linear: no specific role.
One account per connection
You can connect one account for each connection:- one GitHub account,
- one account on each GitLab instance (GitLab.com and a self-managed instance count as two),
- one Bitbucket account,
- one Jira account for all Jira sites, and
- one account in each Linear workspace.