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

Primary objects are the objects used to generate the search record.

Common Model / What You'll See During SetupObjects/Data Brought InKey Fields
TicketPrimary Object:
Repository 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
CommentComments on issues• Body • HTML body • User (UUID) • Ticket (UUID) • Remote created at • Remote ID • Remote data
AttachmentFile attachments on issues• File name • File URL • Ticket (UUID) • Remote ID • Remote data
ProjectRepository projects• Name • Description • Remote ID • Remote data
CollectionRepository collections• Name • Description • Access level (Enum) • Remote ID • Remote data
UserWorkspace members• Name • Avatar • Remote ID • Remote data
RoleUser 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.

Did this page help you?