---
title: "Returns the project settings of the plug-in."
method: GET
path: "/projects/{projectKey}/settings"
tags: ["Project settings"]
---

# Returns the project settings of the plug-in.

`GET /projects/{projectKey}/settings`

## Path parameters

- `projectKey` string, required

## Response `200`

Project settings found

- ProjectSettings
  - `allowUsersToChooseTemplate` boolean — true if a user is allowed to choose another template than the default when creating a new repository
  - `cronExpression` string — the cron expression to use for resetting the settings of associated repositories to the one of the configured template (use null to deactivate the periodic reset)
  - `forkTemplateSyncEnabled` boolean — Sync settings from template to new repository forks
  - `gitMirrorType` 'MIRROR' | 'WITHOUTHISTORY' — Configure how the repository template content should be copied to the new repository.
  - `repoMirrorEnabled` boolean — true if you want the content of a template being mirrored to a repository on its creation
  - `settingsToUse` SettingsToUse — choose all settings which should be copied (when creating a new repository with a template) or reset (when you have the periodic settings reset enabled below) from templates to their associated repositories
    - `accessKeys` boolean
    - `autoDecline` boolean
    - `autoMergeSettings` boolean
    - `branchPermissions` boolean
    - `codeInsights` boolean
    - `defaultReviewersAndReviewerGroups` boolean — Requires Repository Permissions to be enabled
    - `jiraIssues` boolean
    - `pullRequestSettings` boolean
    - `pullRequestTemplate` boolean
    - `repositoryDetails` boolean
    - `repositoryHooks` boolean
    - `repositoryHooksToIgnore` string[]
    - `repositoryPermissions` boolean
    - `requiredBuild` boolean
    - `requiredTasks` boolean
    - `secretScanning` boolean
    - `webhooks` boolean
    - `workflowBranches` boolean
  - `templateFeatureEnabled` boolean — Enables/disables repository templates for project

## Other responses

- `401` — The currently authenticated user does not have PROJECT_ADMIN credentials
- `404` — Project not found or no project settings

## Changes

- **2026-02-13** `34d717f7cf3a` — 8 info
  - added the optional property `settingsToUse/autoDecline` to the response with the `200` status
  - added the optional property `settingsToUse/autoMergeSettings` to the response with the `200` status
  - added the optional property `settingsToUse/codeInsights` to the response with the `200` status
  - added the optional property `settingsToUse/jiraIssues` to the response with the `200` status
  - …4 more
- **2025-02-04** `c973497aa59f` — 2 warning, 1 info
  - removed the optional property `settingsToUse/defaultReviewers` from the response with the `200` status
  - removed the optional property `settingsToUse/reviewerGroups` from the response with the `200` status
  - added the optional property `settingsToUse/defaultReviewersAndReviewerGroups` to the response with the `200` status
- **2024-10-08** `7772d627dec5` — 3 info
  - added the optional property `settingsToUse/defaultReviewers` to the response with the `200` status
  - added the optional property `settingsToUse/pullRequestTemplate` to the response with the `200` status
  - added the optional property `settingsToUse/reviewerGroups` to the response with the `200` status

[Change history](https://skmtc.dev/mibexsoftware/apis/repository-templates-for-bitbucket-rest-api/changes/projects/:projectKey/settings/get.md)

---

[API](https://skmtc.dev/mibexsoftware/apis/repository-templates-for-bitbucket-rest-api.md) · [All operations](https://skmtc.dev/mibexsoftware/apis/repository-templates-for-bitbucket-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mibexsoftware/repository-templates-for-bitbucket-rest-api/revisions/34d717f7cf3a/schema)