# policies#delete

Delete a policy by identifier. Returns 409 Conflict if the policy is referenced by policy sets (unless force=true).

Endpoint: DELETE /pm/api/v1/policies/{identifier}
Version: 1.0
Security: 

## Query parameters:

  - `force` (boolean)
    Force deletion even if the policy is referenced by policy sets
    Example: true

  - `accountIdentifier` (string)
    Harness account ID
    Example: "eBqAoNchMLKigC_qZ5EdC"

  - `orgIdentifier` (string)
    Harness organization ID
    Example: "test-org"

  - `projectIdentifier` (string)
    Harness project ID
    Example: "test-project"

## Path parameters:

  - `identifier` (string, required)
    Identifier of the policy
    Example: "policy-1"

## Header parameters:

  - `x-api-key` (string)
    Harness PAT key used to perform authorization
    Example: "Exercitationem qui."

## Response 400 fields (application/json):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "parameter 'p' must be an integer"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_request"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 409 fields (application/json):

  - `message` (string, required)
    Human-readable warning message
    Example: "Et blanditiis autem tempore."

  - `referenced_by` (array, required)
    Policy sets that reference this policy
    Example: [{"account_id":"Blanditiis est at.","identifier":"Impedit quia quas eum vitae deleniti.","name":"Quisquam voluptas voluptas.","org_id":"Quam accusantium numquam ipsum molestias exercitationem.","project_id":"Itaque necessitatibus aut dolor tempora ullam esse."},{"account_id":"Blanditiis est at.","identifier":"Impedit quia quas eum vitae deleniti.","name":"Quisquam voluptas voluptas.","org_id":"Quam accusantium numquam ipsum molestias exercitationem.","project_id":"Itaque necessitatibus aut dolor tempora ullam esse."},{"account_id":"Blanditiis est at.","identifier":"Impedit quia quas eum vitae deleniti.","name":"Quisquam voluptas voluptas.","org_id":"Quam accusantium numquam ipsum molestias exercitationem.","project_id":"Itaque necessitatibus aut dolor tempora ullam esse."},{"account_id":"Blanditiis est at.","identifier":"Impedit quia quas eum vitae deleniti.","name":"Quisquam voluptas voluptas.","org_id":"Quam accusantium numquam ipsum molestias exercitationem.","project_id":"Itaque necessitatibus aut dolor tempora ullam esse."}]

  - `referenced_by.account_id` (string, required)
    Harness account ID
    Example: "Qui fugit."

  - `referenced_by.identifier` (string, required)
    Identifier of the referencing policy set
    Example: "Nihil ab dolore aliquid."

  - `referenced_by.name` (string, required)
    Name of the referencing policy set
    Example: "Dolor culpa quae dolor ut qui tempora."

  - `referenced_by.org_id` (string)
    Harness organization ID
    Example: "Qui quo sunt et id."

  - `referenced_by.project_id` (string)
    Harness project ID
    Example: "Est laboriosam temporibus error voluptatum."


## Response 204 fields