---
title: "🛡️👤 Set the enabled JIRA projects."
method: PUT
path: "/settings/jira/projects"
tags: ["settings", "default"]
---

# 🛡️👤 Set the enabled JIRA projects.

`PUT /settings/jira/projects`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/settings/jira/projects`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/settings/jira/projects/put.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- JIRAProjectsRequest: Enable or disable a JIRA project.
  - `account` integer, required: Account ID.
  - `projects` object, required: Map from project keys to their enabled/disabled flags.

## Response `200`

Current JIRA project settings.

- JIRAProject[]: List of JIRA project activity settings.
  - `name` string, required: Long name of the project.
  - `key` string, required: Short prefix of the project.
  - `id` string, required: Internal project identifier that corresponds to `project` in `/filter/jira`. Note: this is a string even though this looks like an integer. That's what JIRA API sends us.
  - `avatar_url` string, url, required: Avatar URL of the project.
  - `enabled` boolean, required: Indicates whether this project is enabled for analysis.
  - `issues_count` integer, required: Total number of issues in the project.
  - `last_update` string, date-time, nullable, required: Timestamp of the last event in the project. Can be `null` if there are no issues.

## Other responses

- `400`: Request is invalid.
- `403`: The user is not an admin of this account.
- `404`: The user or the account was not found.
- `422`: The JIRA installation does not exist.

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)