# SETTINGS

- [Settings overview](https://help.swarmia.com/settings/configuration.md): The article provides an overview of settings to ensure your data is accurate in Swarmia and links you to further reading and the related settings in the Swramia app.
- [Team settings](https://help.swarmia.com/settings/configuration/team-setup.md): Configure Swarmia and get up and running with your team
- [Team](https://help.swarmia.com/settings/team.md)
- [Team PR exclusions](https://help.swarmia.com/settings/team/team-pr-exclusions.md)
- [Issue ownership](https://help.swarmia.com/settings/team/issue-ownership.md)
- [Team notifications](https://help.swarmia.com/settings/team/team-notifications.md)
- [Sprint configuration](https://help.swarmia.com/settings/team/sprints.md): To view Jira data in Swarmia, you must first assign the appropriate Jira board to your team.
- [Organization](https://help.swarmia.com/settings/organization.md)
- [Creating & managing teams](https://help.swarmia.com/settings/organization/managing-teams.md)
- [CSV team import](https://help.swarmia.com/settings/organization/managing-teams/csv-team-import.md)
- [Contributors](https://help.swarmia.com/settings/organization/contributors.md)
- [Roles and permissions](https://help.swarmia.com/settings/organization/managing-users-and-roles.md): Overview of Swarmia access control.
- [Inviting team members](https://help.swarmia.com/settings/organization/inviting-team-members.md): Invite members with by sharing a link or via Slack.
- [Investment categories](https://help.swarmia.com/settings/organization/investment-balance.md): Everything you need to know about setting up your Investment Balance and configuring your organization's categories.
- [Automatic categorization](https://help.swarmia.com/settings/organization/investment-balance/automatic-categorization.md): Automatic investment balance categorization works to catch issues that slip your rules or to categorize entire breakdowns without rules.
- [Deployments](https://help.swarmia.com/settings/organization/configuring-deployments-in-swarmia.md): Set up deployments by creating an application and selecting your source.
- [Generate deployments from merged pull requests](https://help.swarmia.com/settings/organization/configuring-deployments-in-swarmia/generate-deployments-from-merged-pull-requests.md): The simplest proxy for deployments is to assume a merged pull request is immediately deployed.
- [Generate deployments from GitHub deployments](https://help.swarmia.com/settings/organization/configuring-deployments-in-swarmia/generate-deployments-from-github-deployments.md): If your release workflow already makes use of GitHub deployments, Swarmia can automatically track those deployments.
- [Generate deployments from GitHub checks](https://help.swarmia.com/settings/organization/configuring-deployments-in-swarmia/generate-deployments-from-github-checks.md): Swarmia can generate deployments automatically from your CI/CD pipeline, using GitHub checks.
- [Generate deployments via the API](https://help.swarmia.com/settings/organization/configuring-deployments-in-swarmia/generate-deployments-via-the-deployment-api.md): Deployment API gives you flexibility and a full control of deployment data, including tracking multiple environments.
- [Generate deployments for monorepos via the API](https://help.swarmia.com/settings/organization/configuring-deployments-in-swarmia/generate-deployments-via-the-deployment-api/generate-deployments-for-monorepos.md): How to setup the Swarmia deployments API to track deployments from monorepos
- [Pull requests](https://help.swarmia.com/settings/organization/pull-request-data-quality.md): Create filters to automatically exclude specific pull requests from all Swarmia metrics
- [Linking pull requests to issues](https://help.swarmia.com/settings/organization/linking-pull-requests-to-issues.md): Linking pull requests to issues allows you to group work by issues. This article describes the ways Swarmia can detect which issue a pull request is related to.
- [Integrations](https://help.swarmia.com/settings/integrations.md)
- [Code hosting platforms](https://help.swarmia.com/settings/integrations/code-hosting-platforms.md): Sync version control activity an repository metadata to Swarmia.
- [GitHub](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github.md): Sync GitHub activity an repository metadata to Swarmia.
- [GitHub Enterprise Server](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/github-enterprise-server.md): Installation instructions for self-hosted GitHub Enterprise Server
- [Multiple GitHub organizations](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/multiple-github-organizations.md)
- [Forked repositories](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/github-fork-repository-in-swarmia.md)
- [Troubleshooting](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/troubleshooting.md)
- [Reinstalling the Swarmia GitHub app](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/troubleshooting/reinstalling-the-swarmia-github-app.md): This article describes how to reinstall the Swarmia GitHub app from the GitHub Marketplace
- [Updating app permissions](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/troubleshooting/github-permissions.md)
- [Installing Swarmia outside of GitHub Marketplace](https://help.swarmia.com/settings/integrations/code-hosting-platforms/github/troubleshooting/github-app-without-marketplace.md): Installing the Swarmia GitHub app without GitHub Marketplace
- [GitLab](https://help.swarmia.com/settings/integrations/code-hosting-platforms/gitlab.md): How to integrate your GitLab Server or GitLab Cloud instance to Swarmia and what permissions are required.
- [Issue trackers](https://help.swarmia.com/settings/integrations/issue-trackers.md)
- [Jira](https://help.swarmia.com/settings/integrations/issue-trackers/jira.md): Learn how to connect your Jira organization to Swarmia.
- [Jira configuration](https://help.swarmia.com/settings/integrations/issue-trackers/jira/jira-setup.md): Every organization uses Jira in a slightly different way. That's why we let you configure your Jira settings in a way that supports your teams current practices.
- [Jira Server and Jira Data Center](https://help.swarmia.com/settings/integrations/issue-trackers/jira/jira-server-and-jira-data-center.md)
- [Multiple Jira organizations](https://help.swarmia.com/settings/integrations/issue-trackers/jira/multiple-jira-organizations.md)
- [Limiting Jira project access](https://help.swarmia.com/settings/integrations/issue-trackers/jira/limiting-jira-project-access.md): How to limit what projects Swarmia's Jira integration has access to.
- [Best practices](https://help.swarmia.com/settings/integrations/issue-trackers/jira/jira-best-practices.md): While Swarmia adapts to any kind of Jira configuration, we wanted to share an example that's easy to set up. Our recommendation tries to strike a balance. This ensures data quality while also leaving
- [Troubleshooting](https://help.swarmia.com/settings/integrations/issue-trackers/jira/troubleshooting.md): Troubleshooting common issues with the Jira integration.
- [Linear](https://help.swarmia.com/settings/integrations/issue-trackers/linear.md): Learn how to connect your Linear organization to Swarmia.
- [Linear configuration](https://help.swarmia.com/settings/integrations/issue-trackers/linear/linear-configuration.md)
- [Private Linear teams](https://help.swarmia.com/settings/integrations/issue-trackers/linear/private-linear-teams.md): How to sync issue data for private teams in Linear to Swarmia
- [Disconnect Linear](https://help.swarmia.com/settings/integrations/issue-trackers/linear/disconnect-linear.md)
- [Messaging apps](https://help.swarmia.com/settings/integrations/messaging-apps.md)
- [Slack](https://help.swarmia.com/settings/integrations/messaging-apps/slack.md): Learn how to connect your Slack organization to Swarmia.
- [Private Slack channels](https://help.swarmia.com/settings/integrations/messaging-apps/slack/adding-swarmia-to-a-private-slack-channel.md)
- [Microsoft Teams](https://help.swarmia.com/settings/integrations/messaging-apps/microsoft-teams.md): Learn how to connect your organization's Microsoft Teams to Swarmia.
- [Adding Swarmia to a Microsoft Teams channel](https://help.swarmia.com/settings/integrations/messaging-apps/microsoft-teams/adding-swarmia-to-a-microsoft-teams-channel.md)
- [Authentication](https://help.swarmia.com/settings/integrations/authentication.md): Swarmia supports authentication with GitHub, Google, Microsoft, and Okta.
- [GitHub Authentication](https://help.swarmia.com/settings/integrations/authentication/github-authentication.md): Use GitHub authentication with your Swarmia organization
- [Google Single Sign-On](https://help.swarmia.com/settings/integrations/authentication/google-single-sign-on.md): Use Google authentication with your Swarmia organization
- [Frequently asked questions](https://help.swarmia.com/settings/integrations/authentication/google-single-sign-on/frequently-asked-questions.md)
- [Microsoft Entra ID Single Sign-On](https://help.swarmia.com/settings/integrations/authentication/microsoft-entra-id-single-sign-on.md): Use Microsoft Entra ID authentication with your Swarmia organization
- [Frequently asked questions](https://help.swarmia.com/settings/integrations/authentication/microsoft-entra-id-single-sign-on/frequently-asked-questions.md)
- [Okta Single Sign-On](https://help.swarmia.com/settings/integrations/authentication/okta-single-sign-on.md): Instructions for enabling Okta Single Sign-On with Swarmia
- [HR systems](https://help.swarmia.com/settings/integrations/hr-systems.md): Learn how to set up your HR system integration with Swarmia.
- [Workday](https://help.swarmia.com/settings/integrations/hr-systems/workday.md)
- [Upload time off data via CSV](https://help.swarmia.com/settings/integrations/hr-systems/upload-time-off-data-via-csv.md): Learn how to upload your time off periods to Swarmia using CSV files.
- [Data export](https://help.swarmia.com/settings/integrations/data-export.md)
- [Data cloud](https://help.swarmia.com/settings/integrations/data-export/data-cloud.md)
- [Export data as a CSV file](https://help.swarmia.com/settings/integrations/data-export/export-data-as-a-csv-file.md)
- [MCP server](https://help.swarmia.com/settings/integrations/mcp-server.md): How to connect Swarmia MCP to your AI client
- [AI coding tool integrations](https://help.swarmia.com/settings/integrations/ai-coding-tool-integrations.md): Enabling GitHub Copilot, Cursor, and Claude Code metrics
- [GitHub Copilot integration](https://help.swarmia.com/settings/integrations/ai-coding-tool-integrations/github-copilot-integration.md): Enabling GitHub Copilot metrics
- [Cursor integration](https://help.swarmia.com/settings/integrations/ai-coding-tool-integrations/cursor-integration.md): Enabling Cursor metrics
- [Claude Code integration](https://help.swarmia.com/settings/integrations/ai-coding-tool-integrations/claude-code-integration.md): Enabling Claude Code metrics with Analytics API or OpenTelemetry monitoring
- [Proxy agent](https://help.swarmia.com/settings/integrations/proxy-agent.md)
- [Swarmia APIs](https://help.swarmia.com/settings/integrations/swarmia-apis.md): Programmatic access to Swarmia data & features
- [Built In reports](https://help.swarmia.com/settings/integrations/swarmia-apis/built-in-reports.md)
- [Custom reports](https://help.swarmia.com/settings/integrations/swarmia-apis/custom-reports.md)
- [Team management](https://help.swarmia.com/settings/integrations/swarmia-apis/team-management.md)
- [Time offs](https://help.swarmia.com/settings/integrations/swarmia-apis/time-off-api.md)
- [Export API v0](https://help.swarmia.com/settings/integrations/swarmia-apis/export-api.md): Swarmia provides an API for exporting data into e.g. spreadsheets or dashboards.
- [Personal](https://help.swarmia.com/settings/personal.md)
- [Personal notifications](https://help.swarmia.com/settings/personal/notifications.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.swarmia.com/settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.