Setting up BitBucket as a Source

Connecting BitBucket makes it easy to turn your repository content into trusted, searchable knowledge. Learn how to connect your BitBucket repositories, manage permissions, and turn existing code and documentation into resources that power intelligent Answers.

๐Ÿ‘ฅ

Access Required

Guru Access: You need to be an Admin, Source Creator, or relevant custom role to set up Sources

Bitbucket Access: The authenticating user must be an Admin in Bitbucket.

Setting Up BitBucket as a Source

  1. In Guru, go to Manage.
  2. Select Sources, then click Add Source.
  3. Choose Bitbucket from the list of integrations.
  4. Authenticate by finding your workspace ID, navigating to your workspace settings, and copy & paste the Workspace ID when prompted.
  5. Add a display name for the Source (optional) and click Connect Source.
  6. Assign which Guru Groups should have access to this content.

Objects Synced from BitBucket

Bitbucket CategoryCommon Model / What You'll See During SetupObjects/Data Brought InKey Fields
IssuesTicketRepository issuesโ€ข Name โ€ข Description โ€ข Ticket type โ€ข Status (Enum) โ€ข Priority (Enum) โ€ข Creator (UUID) โ€ข Assignees (Array) โ€ข Project (Unknown) โ€ข Collections (Array) โ€ข Ticket URL โ€ข Remote created at โ€ข Remote updated at โ€ข Remote data
IssuesCommentComments on issuesโ€ข Body โ€ข HTML body โ€ข User (UUID) โ€ข Ticket (UUID) โ€ข Remote created at โ€ข Remote ID โ€ข Remote data
IssuesAttachmentFile attachments on issuesโ€ข File name โ€ข File URL โ€ข Ticket (UUID) โ€ข Remote ID โ€ข Remote data
RepositoriesProjectRepository projectsโ€ข Name โ€ข Description โ€ข Remote ID โ€ข Remote data
RepositoriesCollectionRepository collectionsโ€ข Name โ€ข Description โ€ข Access level (Enum) โ€ข Remote ID โ€ข Remote data
MembersUserWorkspace membersโ€ข Name โ€ข Avatar โ€ข Remote ID โ€ข Remote data
MembersRoleUser roles and permissionsโ€ข Name โ€ข Ticket actions (Array) โ€ข Remote data

Permissions

  • When you connect Bitbucket as a source in Guru, you'll permission that content in Guru. Learn more here.
  • If someone is not provided with access in Guru to this source, they will not see Bitbucket results in searches or when chatting with Guru.