# Adaptive Policy Management

# Overview

The Adaptive Policy Management REST APIs and Model, allow the creation, deletion, and modification of policies, policy sets, and assigning policies to policy sets.  All policies must be inherited from a policy template.  Only those evaluation conditions that are defined for the template can be assigned to the policy. Once a policy is assigned to a policy set, it must be given an evaluation priority. If the priority is changed, or a policy added or removed, the priority of the other policies will be automatically reordered.

## What This API Does
- Create, modify, and delete policies
- Manage policy sets and assignments
- Configure policy templates and evaluation conditions
- Set and manage policy priorities

## Authentication
All API calls require valid authentication via Bearer token in Authorization header.

## Error Handling
The API uses standard HTTP status codes with detailed error messages in the response body.

## Common Error Responses
All endpoints may return these common error responses:
- **400 Bad Request**: Invalid input data or validation errors
- **401 Unauthorized**: Missing or invalid authentication
- **403 Forbidden**: Insufficient permissions
- **404 Not Found**: Requested resource doesn't exist
- **409 Conflict**: Resource conflict (e.g., duplicate names)
- **422 Unprocessable Entity**: Business rule violations
- **500 Internal Server Error**: Unexpected server errors

Version: 0.0.10
License: RUCKUS Cloud Privacy Policy

## Servers

RUCKUS One API host for North American region.
```
https://api.ruckus.cloud
```

RUCKUS One API host for European region.
```
https://api.eu.ruckus.cloud
```

RUCKUS One API host for Asian region.
```
https://api.asia.ruckus.cloud
```

## Security

### bearerAuth

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

 - [Adaptive Policy Management](https://docs.ruckus.cloud/_bundle/deprecated_apis/policy-mgmt-0.0.10.1.yaml)

## Policy sets

 - [POST /policySets](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/createpolicyset.md): Creates a new policy set from the provided values. A policy set is a collection of policies that can be assigned to external services for network access control. The request body must include the poli
 - [POST /policySets/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/getallpolicysetsbyquery.md): Returns the list of policy sets using the specified query.
 - [DELETE /policySets/{policySetId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/deletepolicyset.md): Deletes the policy set, may not be assigned to a service.
 - [GET /policySets/{policySetId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/getpolicysetbyid.md): Retrieves the requested policy set.
 - [PATCH /policySets/{policySetId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/updatepolicyset.md): Updates the policy set from the requested values.
 - [GET /policySets/{policySetId}/assignments](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/getallpolicysetassignments.md): Gets the list of assignments for the specified policy set.
 - [POST /policySets/{policySetId}/assignments/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/getallpolicysetsassignmentsbyquery.md): Returns the list of assignments for the specified policy set using the specified query.
 - [GET /policySets/{policySetId}/assignments/{assignmentId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/getassignmentbyid.md): Retrieves the requested policy set assignment.
 - [GET /policySets](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policy-sets/getallpolicysets.md): Retrieves a paginated list of policy sets. A policy set is a collection of policies that can be assigned to external services for network access control. This endpoint returns policy sets with paginat
## Policies

 - [GET /policySets/{policySetId}/prioritizedPolicies](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallprioritizedpolicies.md): Gets the list of prioritized policies for the specified policy set.
 - [DELETE /policySets/{policySetId}/prioritizedPolicies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/removemappedpolicyset.md): Removes a policy from a policy set.
 - [GET /policySets/{policySetId}/prioritizedPolicies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getprioritizedrulebyid.md): Retrieves the requested prioritized policy.
 - [PUT /policySets/{policySetId}/prioritizedPolicies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/assignpolicytopolicysetwithpriority.md): Assigns a policy to a policy set with a specific priority.
 - [POST /policyTemplates/policies/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallpoliciesacrosstemplatesbyquery.md): Returns the list of policies across all templates using the specified query.
 - [POST /policyTemplates/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getalltemplatesbyquery.md): Returns the list of policy templates using the specified query.
 - [GET /policyTemplates/{templateId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getpolicytemplatebyid.md): Retrieves the requested policy template.
 - [GET /policyTemplates/{templateId}/attributes](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getattributesfortemplate.md): Gets the list of attributes for the specified template.
 - [POST /policyTemplates/{templateId}/attributes/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/queryattributefortemplate.md): Returns the list of attributes for the specified template using the specified query.
 - [GET /policyTemplates/{templateId}/attributes/{attributeId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getattributesbyidfortemplate.md): Retrieves the requested template attribute.
 - [GET /policyTemplates/{templateId}/policies](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallpoliciesundertemplate.md): Gets the list of policies that are based off of this template.
 - [POST /policyTemplates/{templateId}/policies](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/createpolicy.md): Creates a policy from the requested values, and based on the specified parent. If the content type of "application/ruckus.one.v1-synchronous+json" is provided, then the method will be synchronous, and
 - [POST /policyTemplates/{templateId}/policies/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallpoliciesfortemplatebyquery.md): Returns a paginated list of policies that are based on the specified template. This endpoint accepts query criteria in the request body to filter and search policies by various attributes such as name
 - [DELETE /policyTemplates/{templateId}/policies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/deletepolicy.md): Deletes the policy and conditions, may not be assigned to a service.
 - [GET /policyTemplates/{templateId}/policies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getpolicybyid.md): Retrieves the requested policy.
 - [PATCH /policyTemplates/{templateId}/policies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/updatepolicy.md): Updates the policy from the requested values. The policy template assigned to this policy cannot be changed.
 - [GET /policyTemplates/{templateId}/policies/{policyId}/conditions](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallconditionforpolicy.md): Retrieves the list of conditions for the policy.
 - [POST /policyTemplates/{templateId}/policies/{policyId}/conditions](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/createpolicycondition.md): Creates a condition and applies it to the policy.
 - [DELETE /policyTemplates/{templateId}/policies/{policyId}/conditions/{conditionId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/deletepolicyconditions.md): Deletes the condition from the specified policy, but only if at least one condition still exists.
 - [GET /policyTemplates/{templateId}/policies/{policyId}/conditions/{conditionId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getconditionbyid.md): Retrieves the requested condition for the policy.
 - [PATCH /policyTemplates/{templateId}/policies/{policyId}/conditions/{conditionId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/updatecondition.md): Updates the policy condition from the requested values.
 - [GET /policyTemplates](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallpolicytemplates.md): Retrieves a paginated list of all policy templates in the system. Policy templates define the structure and rules for creating policies, including allowed return types such as RADIUS_ATTRIB_GROUP and
 - [GET /policyTemplates/policies](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/policies/getallpoliciesacrosstemplates.md): Gets the list of policies across all templates. This method will be removed no sooner than 08/31/2026. The following URL `/policyTemplates/policies/query` can be used for this content.
## radius-attribute-group-migration-controller

 - [POST /migrations/radiusAttributeGroups](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/radius-attribute-group-migration-controller/migrate.md)
## new-policy-engine-controller

 - [POST /policies](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/createpolicy_1.md)
 - [POST /policies/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/querypolicies.md)
 - [GET /policies/rules/responses](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/listresponsetypes.md)
 - [GET /policies/rules/sources](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/listsourcetypes.md)
 - [DELETE /policies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/deletepolicy_1.md)
 - [GET /policies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/getpolicybyid_1.md)
 - [PATCH /policies/{policyId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/updatepolicy_1.md)
 - [POST /policies/{policyId}/assignments/query](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/queryassignments.md)
 - [GET /policies/{policyId}/assignments/{assignmentId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/getassignment.md)
 - [GET /policies/{policyId}/rules](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/listrules.md)
 - [POST /policies/{policyId}/rules](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/createrule.md)
 - [DELETE /policies/{policyId}/rules/{ruleId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/deleterule.md)
 - [GET /policies/{policyId}/rules/{ruleId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/getrulebyid.md)
 - [PATCH /policies/{policyId}/rules/{ruleId}](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/updaterule.md)
 - [GET /policies/{policyId}/rules/{ruleId}/responses](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/listruleresponses.md)
 - [PATCH /policies/{policyId}/rules/{ruleId}/responses](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/replaceruleresponses.md)
 - [GET /policies/{policyId}/rules/{ruleId}/sources](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/listrulesources.md)
 - [PATCH /policies/{policyId}/rules/{ruleId}/sources](https://docs.ruckus.cloud/deprecated_apis/policy-mgmt-0.0.10.1/new-policy-engine-controller/replacerulesources.md)