API Documentation

Update Agent's Supervisor

The Update Agent’s Supervisor API updates the supervisor assigned to an agent in the QEval system. This API is used to modify the reporting hierarchy by assigning a new supervisor to an existing agent.

URL https://{Subdomain}.qevalpro.com/api/ManageUser/UpdateAgentSupervisor
Method POST
Sub Domains “app” or “ai”

1. API Headers

Every API call must include two-factor authentication by providing the following headers:

Header Type Description
Authorisation String Bearer <Generated_Token> (generated after successful login)
X-API-KEY String

<Your_Unique_API_Key> (generated after successful login)

Note: If unavailable, email Qeval@etechtexas.com.

2. Sample Request (Payload)

</> JSON 
{
    "EmpId": "EMP001",
    "SupervisorId": "SUP002"
}

Description for Request Parameters

S.No Name Type Description Is Required?
1 EmpId String Employee ID of the agent whose supervisor needs to be updated Yes
2 SupervisorId String Employee ID of the new supervisor Yes

Validation Rules

Field Validation Rule
EmpId Required and must reference an existing employee
SupervisorId Required and must reference an existing supervisor
EmpId Cannot be blank or null
SupervisorId Cannot be blank or null

3. Response Examples

Success

</> JSON 
{
    "Message": "Updated Agent Supervisor successfully."
}

Status Codes

Code Status Description
200 Success Agent supervisor updated successfully

Response Parameters

S.No Name Type Description
1 Message String Status message returned by the API

Failure

Invalid Request

</> JSON 
{
    "Message": "The request is invalid."
}

Status Codes

Code Status Description
400 Bad Request Invalid request format
401 Unauthorised Invalid username/password
405 Method Not Allowed Requested method is not supported for the resource
406 Not Acceptable Exception occurred while processing the request
500 Internal Server Error Server encountered an error

Notes

  • Authentication is mandatory for accessing this API.
  • Both EmpId and SupervisorId are required.
  • The specified supervisor must exist and be configured as a supervisor in the system.
  • The specified employee must exist in the system.
  • This API updates only the supervisor assignment and does not modify any other employee details.
  • A successful response confirms that the reporting hierarchy has been updated.

    ×

    Contact Us