Skip to content
Copyright © 2022-2026 basebox GmbH, all rights reserved.
Licensed to be used in conjunction with basebox, only.

YouTrack

The YouTrack connector lets the basebox assistant query and (optionally) update issues in your JetBrains YouTrack project tracker.

When to use it

Enable YouTrack when you want the assistant to:

  • look up issues by ID, summary, or query,
  • summarise the state of a project, sprint, or release,
  • draft comments or status updates against issues,
  • help triage by surfacing duplicates or related tickets.

Prerequisites

  • A YouTrack instance you can reach from the basebox deployment (cloud or self-hosted).
  • A permanent token for the YouTrack user the assistant should act as.
  • See How to create a YouTrack token.
  • Scopes appropriate for what you want to allow — at minimum YouTrack: Read Issue; add write scopes only if you want the assistant to update tickets.

Configuration

On the Admin → Connectors page, find YouTrack and fill in:

Field Description
Endpoint URL The base URL of your YouTrack, e.g. https://yourorg.youtrack.cloud or https://youtrack.example.org.
Token The permanent token you created. See the help page.

Then:

  1. Click Test connection to verify the URL and token.
  2. Toggle the connector On.

Behaviour in chat

When YouTrack is enabled, the assistant can:

  • resolve issue IDs (e.g. DEV-1042) into a summary and current state,
  • run YouTrack search queries on behalf of the user,
  • optionally update issues, if the token grants write scopes.

Links to YouTrack issues are rendered to open in a new browser tab.

Security notes

  • The token has whatever permissions you grant it. Prefer the smallest set of scopes for your use case.
  • The token can be revoked at any time from the same YouTrack screen on which it was created — see the help page.
  • basebox stores the token encrypted in its configuration database; it is never exposed to end users.