Delete a category or subcategory policy

Request

🔒 Private label — contact sales. Requires a private-label entitlement on your API client.

Marks the SUBCATEGORY or CATEGORY business policy as DELETED.

Security

oauth2ClientCredentials(Required scopes: business-policies:write)

Path

businessPolicyIdstringrequired

Business policy document ID

Example:6a3ebb7893bb2649e19cb8a6

business_idstringrequired

Business identifier for the request

curl -i -X DELETE \
  https://developer.boyahq.com/_mock/v2/openapi/business-policies/category-policies/6a3ebb7893bb2649e19cb8a6 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'business_id: string'

Responses

Business policy deleted successfully

Bodyapplication/json

_idstring

Business policy MongoDB ObjectId

statusstring

Policy status

Enum:"ACTIVE""DISABLED""DELETED"

policyobject(PolicyRefV1Dto)

Parent policy group — either a MongoDB ObjectId string or an expanded PolicyRefV1Dto object

businessstring

Business MongoDB ObjectId this policy belongs to

policy_typestring

Policy scope (e.g. business, budget)

policy_codestring

Policy code inherited from the parent policy group

employeesArray of strings

Employee IDs this policy is scoped to

teamsArray of strings

Team IDs this policy is scoped to

budgetsArray of strings

Budget IDs this policy is scoped to

prioritynumber

Priority order among policies of the same type (lower = higher priority)

workflowobject or null

Approval workflow attached to this policy — null when no approval is required

rulesArray of objects(PolicyRuleV1Dto)

Rules defining the conditions and actions of this policy

namestring

Human-readable name for this business policy

descriptionstring

Optional description for this business policy

createdAtstring

ISO 8601 creation timestamp

updatedAtstring

ISO 8601 last-updated timestamp

Response

{
  "_id": "string",
  "status": "ACTIVE",
  "policy": {
    "_id": "string",
    "status": "ACTIVE",
    "description": "string",
    "policy_code": "string"
  },
  "business": "string",
  "policy_type": "string",
  "policy_code": "string",
  "employees": [
    "string"
  ],
  "teams": [
    "string"
  ],
  "budgets": [
    "string"
  ],
  "priority": 0,
  "workflow": {},
  "rules": [
    { … }
  ],
  "name": "string",
  "description": "string",
  "createdAt": "string",
  "updatedAt": "string"
}