Update a Callback Profile by ID

PATCH Method

Kaleyra.io offers an API that enables you to edit and update the callback profile details based on the ID.

📘
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.

To edit and update the callback profile detail based on ID, perform the following steps:

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 callback profile details

To edit and update the callback profile detail, use the /callback/profiles/<id> endpoint with the following request method:

Request Format

curl --location --request PATCH 'https://<api_domain>/v1/<sid>/callback/profiles/<id>' \
--header 'api-key: <api-key>' \
--header 'Content-Type: <content-type>' \
--data-raw '{
  "title":"<title>",
  "http_method": "<http_method>",
  "url": "<url>",
  "body": "{<body>}",
  "response_message": "<response_message>"
}'

The following table describes the parameter used for editing and updating callback profile details:

Parameter	Data Type	Description	Example	Mandatory
`sid`	String	Account SID (Security Identifier).	HXXXXXXX071IN	Yes
`id`	String	Callback Profile ID (Security Identifier).	SG_bxxxxxxf-2xx4-4xx9-8xx7-fxxxxxxxxxxa	Yes
`api-key`	String	API key generated from Kaleyra.io account.	Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3	Yes
`content-type`	String	The format in which the data is sent.	application/json	Yes
`title`	String	The Callback Profile name. Note*: It should respect the following conditions: Minimum three characters. Only alphabet, numbers, spaces, hyphens, and underscores are allowed.	Callback_Profile_Test_2	No
`http_method`	String	The method type you want to use for the Callback Profile that you are updating. Allowed HTTP Methods are: GET POST PUT DELETE	POST	No
`url`	String	The endpoint on which you want to receive a callback. It could be HTTP or HTTPS.	https://webhook.site/dxxxxxx9-bxx8-4xx2-9xx5-4xxxxxxxxxx8	No
`body`	Object	For POST and PUT methods, you need to provide the callback body. It should be in JSON format. The body is defined by the callback profile requester who is updating the callback profile. For example, the callback profile updated for the Default - No Channel Selected, Dynamic Variable is not defined by default, it has to configure based on the requirements.	{"name":""}	No
`response_message`	String	The message you want to send to a requester when the Payload is successful. It is specific to chatbots and can be used only with chatbots. It may contain replacers. For example, when a request is made for Chatbot and if the payload is successful then you can update the message like, Thank you, {"name": "first_name"} and in response, it will be: Thank you, John, according to the database.	Profile updated successfully!	No

📘
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/v1/HXXXXXXX071IN/callback/profiles/SG_bxxxxxxf-2xx4-4xx9-8xx7-fxxxxxxxxxxa' \
--header 'api-key: Axxxxxxxxxxxxxxxxxxxxxxxxxxxx3' \
--header 'Content-Type: application/json' \
--data-raw '{
  "title":"Callback_Profile_Test_1",
  "http_method": "POST",
  "url": "https://webhook.site/dxxxxxx9-bxx8-4xx2-9xx5-4xxxxxxxxxx8",
  "body": "{"name":""}",
  "response_message": "Profile updated successfully!"
}'

Sample Success Response

The following is the sample success response for editing and updating the callback profile details:

{
    "code": "RBC024",
    "message": "Profile updated successfully",
    "data": {
        "status": "Success",
        "code": "KCLB2009",
        "message": "Profile updated successfully",
        "data": [
            {
                "profileId": "SG_bxxxxxxf-2xx4-4xx9-8xx7-fxxxxxxxxxxa"
            }
        ]
    },
    "error": {},
    "status": 200
}

Sample Failure Response

The following is a sample failure response:

{
    "code": "RBC302",
    "message": "Title already exists. Please provide a unique title",
    "data": {},
    "error": [
        {
            "body": "body/title and body/company_id must be unique"
        }
    ],
    "status": 400
}

For more information about response codes and statuses related to editing and updating callback profile details, see Response Codes and Statuses for Editing and Updating Callback Profile Details by ID.

Updated 12 days ago