Update Delivery Promise

Production

https://api.salla.dev/admin/v2

PUT

/delivery-promises/{id}

Last modified:2026-04-14 13:06:58

This endpoint is used to updates the configuration of an existing delivery promise, including working days, preparation logic, visibility adjustment, locations, and translations.

:::

Scopes

shipping.read_write- Shipping Read & Write

Request

Authorization

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Example

{
    "location": {
        "country": {
            "id": 1473353380
        },
        "region": {
            "id": 566146469
        },
        "cities": [
            {
                "id": 566146469
            },
            {
                "id": 1939592358
            }
        ]
    },
    "delivery_time": {
        "from": 2,
        "to": 4,
        "type": "hours"
    },
    "preparation_time": {
        "from": 1,
        "to": 2,
        "type": "hours"
    },
    "visible": {
        "from": "08:00",
        "to": "15:00",
        "adjust_by_preparation": true
    },
    "working_days": [
        {
            "value": 1
        },
        {
            "value": 2
        },
        {
            "value": 3
        }
    ],
    "holidays": [
        {
            "date": "2026-03-01",
            "repeats_yearly": true,
            "title": "Eid Holiday"
        }
    ],
    "status": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.salla.dev/admin/v2/delivery-promises/1440241834' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "location": {
        "country": {
            "id": 1473353380
        },
        "region": {
            "id": 566146469
        },
        "cities": [
            {
                "id": 566146469
            },
            {
                "id": 1939592358
            }
        ]
    },
    "delivery_time": {
        "from": 2,
        "to": 4,
        "type": "hours"
    },
    "preparation_time": {
        "from": 1,
        "to": 2,
        "type": "hours"
    },
    "visible": {
        "from": "08:00",
        "to": "15:00",
        "adjust_by_preparation": true
    },
    "working_days": [
        {
            "value": 1
        },
        {
            "value": 2
        },
        {
            "value": 3
        }
    ],
    "holidays": [
        {
            "date": "2026-03-01",
            "repeats_yearly": true,
            "title": "Eid Holiday"
        }
    ],
    "status": true
}'

Responses

🟢200Success

application/json

Body

Example

{
    "status": 200,
    "success": true,
    "data": {
        "id": 1440241834,
        "type": "express",
        "status": false,
        "locked": false,
        "name": "التوصيل السريع",
        "description": "توصيل فائق السرعة خلال ساعات قليلة",
        "created_at": {
            "date": "2026-02-11 10:29:24.000000",
            "timezone_type": 3,
            "timezone": "Asia/Riyadh"
        },
        "location": {
            "country": {
                "id": 1473353380,
                "name": "Saudi Arabia"
            },
            "region": {
                "id": 566146469,
                "name": "منطقة مكة المكرمة"
            },
            "cities": [
                {
                    "id": 566146469,
                    "name": "جدة"
                },
                {
                    "id": 1939592358,
                    "name": "مكة المكرمة"
                }
            ]
        },
        "delivery_time": {
            "from": 2,
            "to": 2,
            "type": null
        },
        "preparation_time": {
            "from": 1,
            "to": 1,
            "type": null
        },
        "visible": {
            "from": "08:00",
            "to": "15:00",
            "adjust_by_preparation": true
        },
        "working_days": [
            {
                "name": "الإثنين",
                "value": 1
            },
            {
                "name": "الثلاثاء",
                "value": 2
            },
            {
                "name": "الأربعاء",
                "value": 3
            }
        ],
        "holidays": [
            {
                "date": "2026-03-01",
                "repeats_yearly": true,
                "title": "Eid Holiday"
            }
        ],
        "translations": {
            "en": {
                "name": "Express Delivery",
                "description": "Express delivery within a few hours"
            }
        }
    }
}

🟠404

🟠422

🟠401

Modified at 2026-04-14 13:06:58

Delivery Promise Details

Countries