---
title: "Apply a policy to projects"
method: POST
path: "/rest/api/2/policies/{policyId}/apply"
tags: ["Policies"]
---

# Apply a policy to projects

`POST /rest/api/2/policies/{policyId}/apply`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/api/2/policies/{policyId}/apply`
- Auth: one of:
  - HTTP basic
  - OAuth 2 (authorization code, authorization URL `https://auth.atlassian.com/authorize`, token URL `https://auth.atlassian.com/oauth/token`, scopes: `manage:jira-configuration`)

Adds a policy to a set of projects. Handles partial results: each project is processed independently, and failures on individual projects do not prevent the operation from proceeding on the remaining projects.

Jira Admin only. Returns 200 with the successful and failed project results if at least one project succeeds, or 409 if none do.

## Path parameters

- `policyId` string, required

## Request body

- BulkProjectPolicyRequest
  - `projectIds` integer[]

## Response `200`

200 response

- BulkPolicyOperationResponse
  - `failed` ProjectResult[]
    - `errors` PolicyApplicationViolation[]
      - `entityId` string
      - `entityName` string
      - `entityType` string
      - `remediationHint` string
      - `ruleTypeId` string
    - `message` string
    - `projectId` integer
  - `successful` ProjectResult[]
    - `errors` PolicyApplicationViolation[]
      - `entityId` string
      - `entityName` string
      - `entityType` string
      - `remediationHint` string
      - `ruleTypeId` string
    - `message` string
    - `projectId` integer

## Other responses

- `401`: 401 response
- `403`: 403 response
- `404`: 404 response
- `409`: 409 response

## Changes

- **2026-10-14** `a8f48f288913`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/changes/rest/api/2/policies/:policyId/apply/post.md)

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/revisions/5b336c497218?raw)