curl -X POST "<base_url>/usermanagement/v1/users/renew" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userName": "string",
"serviceName": "rmd",
"period": 30
}'
{
"header": {
"code": 1,
"message": "Account has been renewed successfully",
"response_code": 1
},
"body": {
"userName": "string",
"serviceName": "rmd",
"expiryDate": "04-11-2026"
}
}
{
"header": {
"code": 1001,
"message": "you can renew account when 10 or less days are remaining",
"response_code": 1001
},
"body": {}
}
User Management
Renew a User
Renews an existing user’s subscription for the given period.
POST
/
usermanagement
/
v1
/
users
/
renew
curl -X POST "<base_url>/usermanagement/v1/users/renew" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userName": "string",
"serviceName": "rmd",
"period": 30
}'
{
"header": {
"code": 1,
"message": "Account has been renewed successfully",
"response_code": 1
},
"body": {
"userName": "string",
"serviceName": "rmd",
"expiryDate": "04-11-2026"
}
}
{
"header": {
"code": 1001,
"message": "you can renew account when 10 or less days are remaining",
"response_code": 1001
},
"body": {}
}
Renews an existing user’s subscription for the given
See Errors for the response envelope and the full list of codes.
period. If serviceName is supplied, only that user’s subscription to that service is renewed; if it is omitted, the user account and every service the user is already subscribed to are renewed for the same period.
- URL:
/usermanagement/v1/users/renew - Full URL:
<base_url>/usermanagement/v1/users/renew - Request Method: POST
Authentication
Send the Access Token in theX-AccessToken request header on every authenticated call:
X-AccessToken: YOUR_ACCESS_TOKEN
Request Body
string
required
Username generated when the user was created.
string
Service to apply this to. Omit it to apply to the user and every service they are subscribed to.
number
required
Sample Request
cURL
curl -X POST "<base_url>/usermanagement/v1/users/renew" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userName": "string",
"serviceName": "rmd",
"period": 30
}'
curl -X POST "<base_url>/usermanagement/v1/users/renew" \
-H "X-AccessToken: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"userName": "string",
"serviceName": "rmd",
"period": 30
}'
Response
object
object
Sample Response
{
"header": {
"code": 1,
"message": "Account has been renewed successfully",
"response_code": 1
},
"body": {
"userName": "string",
"serviceName": "rmd",
"expiryDate": "04-11-2026"
}
}
{
"header": {
"code": 1001,
"message": "you can renew account when 10 or less days are remaining",
"response_code": 1001
},
"body": {}
}
{
"header": {
"code": 1,
"message": "Account has been renewed successfully",
"response_code": 1
},
"body": {
"userName": "string",
"serviceName": "rmd",
"expiryDate": "04-11-2026"
}
}
{
"header": {
"code": 1001,
"message": "you can renew account when 10 or less days are remaining",
"response_code": 1001
},
"body": {}
}
Status Codes
| Status | Meaning |
|---|---|
200 | Success. |
500 | Internal Server Error. |
Error codes
Returned inheader.response_code when the request fails.
| Code | Message |
|---|---|
998 | Internal server error |
1001 | Validation error — for example, the account cannot be renewed yet: renewal is allowed only when 10 or fewer days remain. |
1002 | You are not permitted to the resource! |
1003 | Invalid service slug provided |
1004 | Account is not subscribed to this service |
1005 | Invalid username or reseller |