Licensed to be used in conjunction with basebox, only.
// integration
YouTrack
Applies to
Product: Cloud · Server · Audience: Administrator
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).
- For each user, their own permanent token from their YouTrack account.
- 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
YouTrack works with personal credentials: the administrator sets the connector up once, and each user adds their own token. Requests appear in YouTrack under the respective person's name, and YouTrack enforces their permissions (Connector authentication).
As administrator, find YouTrack on the Admin → Connectors page and fill in:
| Field | Description |
|---|---|
| Endpoint URL | The base URL of your YouTrack, e.g. https://yourorg.youtrack.cloud or https://youtrack.example.org. |
Then:
- Click Test connection to verify the URL.
- Toggle the connector On and enable it in the apps where it should be available.
As a user, create a token in your YouTrack account (how-to), add it to the connector and check it with Test connection.
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 and the app enables write tools – they are off by default.
Links to YouTrack issues are rendered to open in a new browser tab.
Security notes
- The token has whatever permissions the user grants it. Recommend the smallest set of scopes for the use case to your users.
- 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 write-only: the interface and API never return it, and administrators do not see it either. The application does not itself encrypt it at rest (Encryption).