# Revoke Bulk Assignments (deprecated)

Revoke multiple license assignments for MSP. This method will be removed no sooner than 08/31/2026. The following endpoint /tenants/{tenantId}/entitlements/assignments/query can be used for this content.

Endpoint: DELETE /assignments
Version: v0.2.0

## Request fields (application/json):

  - `assignmentId` (integer, required)
    Unique identifier of the assignment to be revoked through the bulk operation.
    Example: 231

## Response 204 fields (application/json):

  - `assignments` (array)
    Collection of license assignments associated with the operation.

  - `assignments.createdBy` (string)
    User who created the assignment.
    Example: "rohitmsp.ruckusone5@email.com"

  - `assignments.createdDate` (string)
    Date when the assignment was created.
    Example: "2024-01-16T06:06:02.776Z"

  - `assignments.effectiveDate` (string)
    Effective date of the assignment.
    Example: "2024-01-22T15:08:10Z"

  - `assignments.expirationDate` (string)
    Expiration date of the assignment.
    Example: "2024-02-21T15:07:10Z"

  - `assignments.id` (integer)
    Unique identifier for the assignment.
    Example: 1234

  - `assignments.isTrial` (boolean)
    Indicates whether this assignment is using a trial/temporary license. Trial licenses are typically temporary evaluation licenses that allow customers to test functionality before purchasing full licenses. When true, the assignment uses a temporary entitlement; when false, it uses a standard purchased license.

  - `assignments.licenseType` (string)
    Type of entitlement license assigned.
    Example: "APSW"

  - `assignments.quantity` (integer)
    Quantity of entitlements assigned.
    Example: 5

  - `assignments.revokedBy` (string)
    User who revoked the assignment.

  - `assignments.revokedDate` (string)
    Date when the assignment was revoked.

  - `assignments.status` (string)
    Status of the assignment.
    Enum: "VALID", "REVOKED", "EXPIRED", "FUTURE"

  - `errorBrief` (string)
    Brief error classification providing quick error identification.
    Enum: "NO_CREATED_ASSIGNMENTS", "ASSIGNMENT_CREATION_BAD_INPUT", "NO_MSP_ENTITLEMENTS", "MSP_ENTITLEMENTS_NOT_FOUND", "INSUFFICIENT_MSP_ENTITLEMENTS", "ASSIGNMENT_NOT_FOUND", "TENANT_NOT_MSP", "TENANT_NOT_FOUND", "ENTITLEMENT_ID_NOT_FOUND", "ASSIGNMENT_NOT_REVOCABLE", "ASSIGNMENT_NOT_REPLACEABLE", "ASSIGNMENT_ALREADY_REVOKED", "ASSIGNMENT_IS_EXPIRED", "INTERNAL_SERVER_ERROR", "K2A_MIGRATION_MISSING_EXPORT_DATA", "K2A_MIGRATION_NO_ASSIGNMENT", "K2A_MIGRATION_EXCEPTION", "K2A_MIGRATION_NO_MSP_ENTITLEMENTS", "K2A_MIGRATION_INSUFFICIENT_MSP_ENTITLEMENTS", "LOCK_ACQUISITION_TIMEOUT", "INVALID_INPUT_PARAMETER", "NOT_ACCEPTABLE", "TRIAL_ASSIGNMENT_NOT_ALLOW", "TRIAL_ASSIGNMENT_UPDATE_NOT_ALLOW", "TRIAL_ASSIGNMENT_REVOKE_NOT_ALLOW", "ASSIGNMENT_NOT_REPLACED", "ASSIGNMENT_NOT_CREATED"

  - `errorMessage` (string)
    Detailed error message describing the cause of the operation failure.

  - `success` (boolean)

  - `ve` (object)
    Validation errors containing detailed information about invalid input parameters.

  - `ve.expected` (string)
    Expected value, format, or constraint that the validation was checking against, helping users understand what input would be valid.

  - `ve.object` (string)
    The object or entity type that failed validation, providing context about which data structure or model encountered the error.

  - `ve.objectName` (string)
    Specific name or identifier of the object instance that failed validation, enabling precise error location identification.

  - `ve.value` (string)