diff options
Diffstat (limited to 'doc/integration/trello_power_up.md')
| -rw-r--r-- | doc/integration/trello_power_up.md | 49 |
1 files changed, 15 insertions, 34 deletions
diff --git a/doc/integration/trello_power_up.md b/doc/integration/trello_power_up.md index 96150440e53..8a8952cb594 100644 --- a/doc/integration/trello_power_up.md +++ b/doc/integration/trello_power_up.md @@ -6,44 +6,25 @@ info: To determine the technical writer assigned to the Stage/Group associated w # Trello Power-Up **(FREE)** -The GitLab Trello Power-Up enables you to seamlessly attach -GitLab **merge requests** to Trello cards. +You can use the Trello Power-Up for GitLab to attach +GitLab merge requests to Trello cards.  -## Configuring the Power-Up +## Configure the Power-Up -In order to get started, you must configure your Power-Up. +To configure a Power-Up for a Trello board: -In Trello: +1. Go to your Trello board. +1. Select **Power-Ups** and find the **GitLab** row. +1. Select **Enable**. +1. Select **Settings** (the gear icon). +1. Select **Authorize Account**. +1. Enter the [GitLab API URL](#get-the-api-url) and [personal access token](../user/profile/personal_access_tokens.md#create-a-personal-access-token) with the **API** scope. +1. Select **Save**. -1. Go to your Trello board -1. Select `Power-Ups` to see a listing of all the available Power-Ups -1. Look for a row that says `GitLab` and select the `Enable` button -1. Select the `Settings` (gear) icon -1. In the popup menu, select `Authorize Account` +## Get the API URL -In this popup, fill in your `API URL` and `Personal Access Token`. After that, you can attach any merge request to any Trello card on your selected Trello board. - -## What is my API URL? - -Your API URL should be your GitLab instance URL with `/api/v4` appended in the end of the URL. -For example, if your GitLab instance URL is `https://gitlab.com`, your API URL would be `https://gitlab.com/api/v4`. -If your instance's URL is `https://example.com`, your API URL is `https://example.com/api/v4`. - - - -## What is my Personal Access Token? - -Your GitLab personal access token enables your GitLab account to be accessed -from Trello. - -To find it in GitLab: - -1. In the top-right corner, select your avatar. -1. Select **Edit profile**. -1. On the left sidebar, select **Access Tokens**. - -Learn more about generating a personal access token in the -[Personal Access Token Documentation](../user/profile/personal_access_tokens.md). -Don't forget to check the API scope checkbox! +Your API URL is your GitLab instance URL with `/api/v4` appended at the end of the URL. +For example, if your GitLab instance URL is `https://gitlab.com`, your API URL is `https://gitlab.com/api/v4`. +If your instance URL is `https://example.com`, your API URL is `https://example.com/api/v4`. |