delete__policy_{policyId}

⚠️ TEST ENVIRONMENT ONLY

This API endpoint is currently available only in the TEST environment. It is not yet available in production.

DELETE /policy/{policyId}

Delete AI Policy

Permanently delete an AI governance policy. This operation performs a soft delete, marking the policy as deleted while preserving audit history.

Important Notes:

  • Deletion is a soft delete (marked as deleted but not physically removed from database)

  • Once deleted, the policy will no longer be enforced on AI operations

  • Users must have delete permissions for the policy based on its scope level

  • Only non-deleted policies can be deleted

  • Deleted policies are excluded from list and get operations

Security:

  • Organization boundaries are enforced

  • Permission checks ensure users can only delete policies they have access to

  • Workspace-level and repository-level policies require appropriate delete permissions

  • Deletion operations are logged for audit purposes

Use Cases:

  • Remove obsolete or deprecated policies

  • Clean up unused policies

  • Retire policies that are no longer needed

  • Reorganize policy structure

Best Practice:

Before deleting a policy, consider:

  1. Reviewing any active violations associated with the policy

  2. Documenting the reason for deletion

  3. Communicating the change to relevant stakeholders

  4. Archiving policy content for future reference if needed

TypeScript Client Library

public deletePolicy = async (policyId: string): Promise<ActionResponse> => {
  return this.makeRequest<ActionResponse>(`policy/${policyId}`, 'DELETE', null);
};

Code Samples

# You can also use wget
curl -X DELETE https://backend.flashback.tech/policy/{policyId} \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

Parameters

Name
In
Type
Required
Description

policyId

path

string

true

Unique identifier of the policy

Example responses

200 Response

{
  "success": true,
  "message": "Policy deleted successfully"
}

Responses

Status
Meaning
Description
Schema

200

Policy deleted successfully

Inline

400

Invalid request

Inline

403

Insufficient permissions

Inline

404

Policy not found

Inline

500

Failed to delete policy

Inline

Response Schema

Status Code 200

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

Operation success status

» message

string

false

none

Success message

Status Code 400

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

none

» message

string

false

none

Error message

Status Code 403

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

none

» message

string

false

none

Error message

Status Code 404

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

none

» message

string

false

none

Error message

Status Code 500

Name
Type
Required
Restrictions
Description

» success

boolean

false

none

none

» message

string

false

none

Error message

To perform this operation, you must be authenticated by means of one of the following methods: BearerAuth

Last updated

Was this helpful?