Update An Sms Notifier
Update an sms notifier
HTTP Request
PATCH/api/notifications/notifiers/sms/:id
Authorization
Authorization
- Required: Yes
- Permission: Staff with SMSNotifierPermission or Admin
- Permission Code: 2813
- Authentication: Token-based (Authorization: Token <your_api_key>)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | Integer | Yes | Unique ID of the sms notifier to update |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | String | Yes | Name of the sms notifier |
| backend | String | Yes | Backend name of the sms notifier (choices: `ippanel`, `melipayamak`) |
| settings | JsonField | No | Extra settings required for the sms notifier (default: empty dict) |
Setting Validation
The settings field if provided should match the following rules:
MeliPayamak
- It should contain a key named
tokenwith a string value - It may contain a key named
numberwith a string value of more than 4 digits
Ippanel
- It should contain a key named
tokenwith a string value - It should contain a key named
from_numberwith a string value of an iraninan mobile number starting with+98
Example Requests
- 🐍 Python
- 🌐 Curl
1import requests
2response = requests.post('http://www.example.com/api/notifications/notifiers/sms/49', json={
3 "name": "some edited name"
4})
5print(response.json())1curl -X POST "http://www.example.com/api/notifications/notifiers/sms/49" -H "Content-Type: application/json" -d '{
2 "name": "some edited name"
3}Response Fields
| Field | Type | Description |
|---|---|---|
| id | Integer | Unique ID of the sms notifier. |
| name | String | Name of the sms notifier |
| backend | String | Name of the sms notifier backend |
| settings | JsonField | Json key-value settings required for each notifier |
| created_at | String (ISO 8601) | Timestamp when the sms notifier was created. |
| updated_at | String (ISO 8601) | Timestamp when the sms notifier was last updated. |
Response Example
{
"id": 6,
"name": "edited_melipayamak",
"backend": "melipayamak",
"settings": {
"token": "another_token",
"number": "091502306589"
},
"created_at": "2025-12-28T15:56:29.610626Z",
"updated_at": "2025-12-28T16:06:49.107530Z"
}