# Manage Entitlements

## Get Tenant Entitlement Assignments

 - [POST /tenants/{tenantId}/entitlements/assignments/query](https://docs.ruckus.cloud/api/entitlement-0.2.0/manage-entitlements/getentitlementassignments.md): Retrieves entitlement assignments allocated to a specific customer tenant by an MSP.
Entitlement assignments represent the allocation of licenses from a provider's bulk license pool to individual MSP_EC tenants, enabling customers to use specific products and services based on the assigned license quantities and types.
This endpoint allows providers to view which licenses have been assigned to a tenant, and monitor assignment details including quantities, expiration dates, and current status.

Use cases: track license allocations to customer tenants, verify assignment status before making changes.

## Create a Self Assignment

 - [POST /tenants/self/entitlements/assignments](https://docs.ruckus.cloud/api/entitlement-0.2.0/manage-entitlements/createentitlementassignment.md): Creates a self assignment by allocating licenses from the MSP's bulk entitlement pool to their own tenant account. Self assignments allow MSPs to assign licenses to their own devices rather than to customer tenants. This is useful when the MSP needs to manage and license their own device separately from customer allocations.

## Get MSP Self Assignments

 - [POST /tenants/self/entitlements/assignments/query](https://docs.ruckus.cloud/api/entitlement-0.2.0/manage-entitlements/getselfentitlementassignments.md): Retrieves self assignments, which are entitlement allocations where the tenant manages their own license distribution for internal use.
An MSP uses self assignments to allocate licenses from their bulk license pool to their own tenant account, rather than assigning them to customer tenants.
Self assignments represent licenses that the provider reserves for managing their own devices.
This allows providers to separate their internal license consumption from customer allocations for better tracking and resource management.

Use cases: track internally allocated resources separately from customer assignments.

## Delete Self Assignment

 - [DELETE /tenants/self/entitlements/assignments/{id}](https://docs.ruckus.cloud/api/entitlement-0.2.0/manage-entitlements/deleteentitlementassignment.md): Deletes an active self assignment by marking it as revoked. When a license is deleted, it is not physically removed from the system but instead marked as revoked and can no longer be used. The assignment record is preserved for audit purposes. Returns a 204 no content status code on successful deletion, or a 409 conflict if the assignment has already expired or been revoked.

## Update a Self Assignment

 - [PATCH /tenants/self/entitlements/assignments/{id}](https://docs.ruckus.cloud/api/entitlement-0.2.0/manage-entitlements/updateentitlementassignment.md): Updates an existing self assignment where the MSPs has allocated licenses to their own tenant account. Quantity and expiry date can be modified for self assignments. When updating assignments, existing assignments will be revoked and new assignments will be created with the updated fields. This allows MSPs to adjust the number of licenses allocated to their own infrastructure as their needs change.

