Edit and Update Subaccount Details
PATCH Method
Kaleyra.io offers an API that enables you to edit and update the sub-account details associated with a parent account. The sub-account can be identified based on the subaccount's SID and the parent's SID and API-Key.
Note:
PATCH Method allows passing in the API request only the attributes that need to be edited. All attributes not passed in the API request will retain their current value without any modification.
Base URL
https://<api_domain>/v1/<SID>
API Domain and Value
| api_domain | Value |
|---|---|
| IN pod | api.in.kaleyra.io |
| SG Pod | api.kaleyra.io |
| EU Pod | api.eu.kaleyra.io |
| NA pod | api.na.kaleyra.ai |
API request to edit and update the sub-account detail
To edit and update the sub-account detail, use the /subaccounts/<subaccount_sid> endpoint with the following request method:
Request Format
curl --location --request PATCH 'https://<api_domain>/api/v1/<sid>/subaccounts/<subaccount_sid>' \
--header 'api-key: <api-key>' \
--header 'Content-Type: <content-type>' \
--data-raw '{
"account_name": "<account-name>",
"credit_amount": <credit-amount>,
"low_balance_alert": <low-balance-alert>
}'
The following table describes the parameter used for edit and update sub-account details:
| Parameter | Data Type | Description | Applicable | Mandatory | Example |
|---|---|---|---|---|---|
sid | String | Parent account SID (Security Identifier). | Always applicable. | Yes | HXXXXXXX071IN |
subaccount_sid | String | Subaccount SID (Security Identifier). | Always applicable. | Yes | HXXXXXXX071IN_1710 |
content-type | String | The format in which the data is sent. | Always applicable. | Yes | application/json |
api-key | String | Parent account API key. | Always applicable. | Yes | Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3 |
account_name | String - only alphanumeric, no special characters | Update sub-account name. | Always applicable. | No | John Doe1 |
credit_amount | Number | The credit amount you want to update for the sub-account user. | Applicable when subaccount_credit_type = assigned. | No | 5 |
low_balance_alert | Boolean | Identifier to send low balance alerts to specific email addresses . | Applicable only when subaccount_credit_type = assigned. | No | True/False |
low_balance_limit | Number | The threshold amount to send an alert email if Subaccount’s balance goes below it. | Applicable when subaccount_credit_type = assigned and low_balance_alert is true. | No | 5 |
low_balance_emails | Array of strings - valid email | Email addresses to which low balance alert is sent. You can add more than one email address separated by a comma (,). | Applicable when subaccount_credit_type = assigned and low_balance_alert is true. | No | [[email protected]] |
monthly_limit | Number | The monthly limit you want to update for a sub-account user. | Applicable when subaccount_credit_type = shared and monthly_limit is already added while creating the sub-account. | No | 300 |
status | String | Valid statuses are: suspend and reactivate. The valid statuses are: suspend and reactivate. | Always applicable. | No | suspend/reactiv |
return_budget | Boolean | Identifier to return the credit amount/ monthly limit of sub-account to the parent account. | Applicable when status = suspend. | No | True/False |
Note:
At least you must pass one of the parameters listed to get a successful response.
Sample Request
The following is the sample request:
curl --location --request PATCH 'https://api.in.kaleyra.io/api/v1/HXXXXXXX071IN/subaccounts/HXXXXXXX071IN_1710' \
--header 'api-key: Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3' \
--header 'Content-Type: application/json' \
--data-raw '{
"account_name": "John Doe1",
"credit_amount": 5,
"low_balance_alert": false
}'
Sample Success Response
The following is the sample success response for editing and updating the sub-account details:
{
"code": "RBC103",
"message": "Subaccount Edited Successfully",
"data": {
"account_name": "John Doe1",
"email": "[email protected]",
"status": "active",
"sid": "HXXXXXXX071IN_1710",
"api_key": "Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3",
"channels": [
"sms"
],
"low_balance_alert": false,
"subaccount_credit_type": "assigned",
"balance": 4
},
"error": {},
"status": 200
}
Sample Failure Response
The following is a sample failure response:
{
"code": "RBC2327",
"message": "API Key and SID do not belong to parent company",
"data": {},
"error": {},
"status": 401
}
For more information about response codes and statuses related to editing and updating sub-account details, see Response Codes and Statuses for Editing and Updating Subaccount Details and Subaccount Status.
Updated 14 days ago