User Deactivate
Customers and distributor's staff can deactivate users through ActivePlatform. The User Deactivate notification URL allows a vendor service to receive notifications when a user is deactivated.
The general flow for the User Deactivate event includes the following steps:
- A user was deactivated through ActivePlatform.
- ActivePlatform calls the configured notification URL, passing the JSON with the user ID.
- The vendor service validates the request, deactivates the user, confirms the operation or returns details about the occurred error.
- ActivePlatform completes the operation with the user.
POST /user/deactivate?ap_guid={ap_guid}&reseller_id={reseller_id}Arguments
Name | Parameter type | Data type | Description |
|---|---|---|---|
| ap_guid | query | string | Auto-generated installation GUID (Globally Unique Identifier). The ap_guid is used to identify the ActivePlatform installation that called the entry point |
| reseller_id | query | string | Reseller ID who sold the user of the service plan through the ActivePlatform installation |
Event body
Name | Data type | Description | ||
|---|---|---|---|---|
id | string | User ID that was generated in the vendor service | ||
Response model
If a user was successfully deactivated, the vendor service returns:
- 200 HTTP code status.
If a user was not deactivated, the vendor service returns HTTP code and error message.
- HTTP code status.
- JSON with the following information:
Name | Data type | Description | |
|---|---|---|---|
| task | object | ||
| error_message | string | Text message of the occurred error | |
Event example
POST http://example.com/user/deactivate{
"id": "1234567"
}Response example
The user was successfully deactivated:
- HTTP code status: 200 OK.