Skip to main content

Manage Bot Accounts

A group bot can be added as a member to other global projects and groups.

Add Bot Account​

Prerequisite:

  • You must have at least a Maintainer role.

To add a bot account to a group:

  1. From the left sidebar, select Groups and find your group.
  2. From the left sidebar, select Settings > Bot Accounts.
  3. Click the New bot account button.
  4. Enter the token name in the Name field.
  5. Select an access level.
  6. Set an optional expiry date.
  7. Select at least one scope.
  8. Click the Submit button.

You should now see the new bot account listed within the bot accounts table. Above the table you should also see a section for the newly created personal access token. Copy the personal access token, as it cannot be accessed afterwards.

Delete Bot Account​

Prerequisites:

  • You must have at least a Maintainer role.

To delete an existing bot account from a group:

  1. From the left sidebar, select Groups and find your group.
  2. From the left sidebar, select Settings > Bot Accounts.
  3. On the right hand side of the row for the bot account you want to delete, click the Delete bot link.
  4. Confirm that you would like to permanently delete the bot account by clicking the Confirm button.

All memberships associated with the deleted bot will automatically be removed.

Add Membership​

Prerequisite:

  • You must have at least a Maintainer role.

To add a bot account membership to a group:

  1. From the left sidebar, select Groups and find your group.
  2. From the left sidebar, select Members.
  3. Click the Add Member button.
  4. Select the bot account you want to add to the group.
  5. Select an access level (role).
  6. Select an optional Access expiration.
  7. Click the Add member to group button.

Remove Membership​

Prerequisites:

  • You must have at least a Maintainer role.

To remove a bot account membership from a group:

  1. From the left sidebar, select Groups and find your group.
  2. From the left sidebar, select Members.
  3. On the right hand side of the row for the bot account membership you want to remove, click the Remove link.
  4. Confirm that you would like to remove the bot account membership by clicking the Confirm button.