As a supervisor using the 1097 application, I want an API named Allocate API to allocate outbound calls to agents, so that I can ensure calls are distributed effectively among agents for efficient handling without specifying my own ID.

Acceptance Criteria:

API Functionality:

The Allocate API should allow supervisors to allocate outbound call records to specific agents.
Supervisors should be able to specify the agent ID and the list of complaint IDs to allocate.

Request Parameters:

The API should accept the following inputs:
AgentID: ID of the agent to whom the calls are being allocated.
ComplaintIDs: List of complaint IDs to be assigned.

Response:

The API should return a success response with the following details:
Status: Allocation success or failure.
AllocatedComplaintIDs: List of complaint IDs successfully allocated.
FailedComplaintIDs: List of complaint IDs that could not be allocated (with error reasons).

Validation Rules:

The API should validate that:
The AgentID is a valid and active user in the system.
The ComplaintIDs exist in the outbound call record.
The complaints have not already been assigned to another agent.

Concurrency Handling:

The API should prevent duplicate allocations of the same complaint ID to multiple agents.
Audit Trail:

Every allocation should be logged with details such as Agent ID, Complaint IDs, timestamp, and status for audit purposes.

Error Handling:

The API should return appropriate error messages for invalid or missing parameters, such as:

Invalid Agent ID.
Complaint IDs not found or already assigned.
Security:

The API should enforce role-based access control, ensuring only supervisors can allocate calls.
All requests must be authenticated and authorized.