---
title: "Put team policy"
method: PUT
path: "/api/{cloudId}/v1/teams/{teamId}/policies/{policyId}"
tags: ["Team Policies"]
---

# Put team policy

`PUT /api/{cloudId}/v1/teams/{teamId}/policies/{policyId}`

## Request

- Base URL: `https://api.atlassian.com/jsm/ops`
- URL: `https://api.atlassian.com/jsm/ops/api/{cloudId}/v1/teams/{teamId}/policies/{policyId}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.stg.atlassian.com/authorize`
    - Token URL: `https://auth.stg.atlassian.com/oauth/token` scopes: `read:ops-config:jira-service-management`

Put team policy

## Path parameters

- `policyId` string, required
- `teamId` string, required

## Request body

- union
  - TeamAlertPolicyDto
    - `type` string
    - `id` string
    - `name` string
    - `description` string
    - `teamId` string
    - `enabled` boolean
    - `order` number
    - `filter` object
      - `type` string, required
      - `conditions` object[], required
        - `field` string
        - `not` boolean
        - `operation` string
        - `expectedValue` string
        - `order` number
    - `timeRestriction` object
      - `enabled` boolean, required
      - `timeRestrictions` object[], required
        - `startDay` number
        - `startHour` number
        - `startMinute` number
        - `endDay` number
        - `endHour` number
        - `endMinute` number
      - `appliedTimeZone` string, required
    - `alias` string
    - `message` string
    - `alertDescription` string
    - `source` string
    - `entity` string
    - `responders` string[]
    - `actions` string[]
    - `tags` string[]
    - `details` object
    - `continue` boolean
    - `updatePriority` boolean: If set to true, priority of the alert will be updated based on priorityValue. Default value is false
    - `priorityValue` 'P1' | 'P2' | 'P3' | 'P4' | 'P5': Priority value of the alert. Should be one of P1, P2, P3, P4, or P5. This field is used when updatePriority is set to true.
    - `keepOriginalResponders` boolean
    - `keepOriginalDetails` boolean
    - `keepOriginalActions` boolean
    - `keepOriginalTags` boolean
  - TeamNotificationPolicyDto
    - `type` string
    - `id` string
    - `name` string
    - `description` string
    - `teamId` string
    - `enabled` boolean
    - `order` number
    - `filter` object
      - `type` string, required
      - `conditions` object[], required
        - `field` string
        - `not` boolean
        - `operation` string
        - `expectedValue` string
        - `order` number
    - `timeRestriction` object
      - `enabled` boolean, required
      - `timeRestrictions` object[], required
        - `startDay` number
        - `startHour` number
        - `startMinute` number
        - `endDay` number
        - `endHour` number
        - `endMinute` number
      - `appliedTimeZone` string, required
    - `delayAction` object
      - `waitDuration` number, required
      - `delayOption` string, required
      - `delayTime` object, required
        - `hours` number, required
        - `minutes` number, required
    - `deduplicationAction` object
      - `waitDuration` number, required
      - `frequency` number, required
      - `countValueLimit` number, required
      - `deduplicationActionType` string, required
    - `autoCloseAction` object
      - `waitDuration` number, required
      - `durationFormat` string, required
    - `autoRestartAction` object
      - `waitDuration` number, required
      - `durationFormat` string, required
      - `maxRepeatCount` number, required
    - `suppress` boolean

## Response `200`

Returned if the request is successful.

- union
  - TeamAlertPolicyDto
    - `type` string
    - `id` string
    - `name` string
    - `description` string
    - `teamId` string
    - `enabled` boolean
    - `order` number
    - `filter` object
      - `type` string, required
      - `conditions` object[], required
        - `field` string
        - `not` boolean
        - `operation` string
        - `expectedValue` string
        - `order` number
    - `timeRestriction` object
      - `enabled` boolean, required
      - `timeRestrictions` object[], required
        - `startDay` number
        - `startHour` number
        - `startMinute` number
        - `endDay` number
        - `endHour` number
        - `endMinute` number
      - `appliedTimeZone` string, required
    - `alias` string
    - `message` string
    - `alertDescription` string
    - `source` string
    - `entity` string
    - `responders` string[]
    - `actions` string[]
    - `tags` string[]
    - `details` object
    - `continue` boolean
    - `updatePriority` boolean: If set to true, priority of the alert will be updated based on priorityValue. Default value is false
    - `priorityValue` 'P1' | 'P2' | 'P3' | 'P4' | 'P5': Priority value of the alert. Should be one of P1, P2, P3, P4, or P5. This field is used when updatePriority is set to true.
    - `keepOriginalResponders` boolean
    - `keepOriginalDetails` boolean
    - `keepOriginalActions` boolean
    - `keepOriginalTags` boolean
  - TeamNotificationPolicyDto
    - `type` string
    - `id` string
    - `name` string
    - `description` string
    - `teamId` string
    - `enabled` boolean
    - `order` number
    - `filter` object
      - `type` string, required
      - `conditions` object[], required
        - `field` string
        - `not` boolean
        - `operation` string
        - `expectedValue` string
        - `order` number
    - `timeRestriction` object
      - `enabled` boolean, required
      - `timeRestrictions` object[], required
        - `startDay` number
        - `startHour` number
        - `startMinute` number
        - `endDay` number
        - `endHour` number
        - `endMinute` number
      - `appliedTimeZone` string, required
    - `delayAction` object
      - `waitDuration` number, required
      - `delayOption` string, required
      - `delayTime` object, required
        - `hours` number, required
        - `minutes` number, required
    - `deduplicationAction` object
      - `waitDuration` number, required
      - `frequency` number, required
      - `countValueLimit` number, required
      - `deduplicationActionType` string, required
    - `autoCloseAction` object
      - `waitDuration` number, required
      - `durationFormat` string, required
    - `autoRestartAction` object
      - `waitDuration` number, required
      - `durationFormat` string, required
      - `maxRepeatCount` number, required
    - `suppress` boolean

## Other responses

- `401`: Returned if the authentication credentials are incorrect.
- `404`: Returned if the policy is not found.
- `422`: Returned if the payload cannot be validated.

## Changes

- **2026-10-24** `804cddbe79aa`: 8 info
  - added the new optional request property `oneOf[#/components/schemas/TeamAlertPolicyDto]/timeRestriction/timeRestrictions/items/endDay`
  - added the new optional request property `oneOf[#/components/schemas/TeamAlertPolicyDto]/timeRestriction/timeRestrictions/items/startDay`
  - added the new optional request property `oneOf[#/components/schemas/TeamNotificationPolicyDto]/timeRestriction/timeRestrictions/items/endDay`
  - added the new optional request property `oneOf[#/components/schemas/TeamNotificationPolicyDto]/timeRestriction/timeRestrictions/items/startDay`
  - …4 more

[Operation history](https://skmtc.dev/atlassian/apis/jsm-operations-api/changes/api/:cloudId/v1/teams/:teamId/policies/:policyId/put.md)

---

[API](https://skmtc.dev/atlassian/apis/jsm-operations-api.md) - [All operations](https://skmtc.dev/atlassian/apis/jsm-operations-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/jsm-operations-api/revisions/804cddbe79aa?raw)