Skip to content

    Arabic or English · ↑↓ to move · Enter to open · Esc to close

    العربية
    On this page

    Messages

    Edit a sent text (≤15 min)

    PATCH/v2/messages/{messageId}
    • Scope:messages:send
    • Idempotency-Key:optional
    • number key ok— Also accepts the legacy per-number x-api-key, for its own number.
    • sends messages

    Your own text messages only; the new text passes the content rules.

    Parameters

    Path

    NameTypeConstraintsDescription
    messageIdrequiredTypestringConstraints—DescriptionMessage id returned by POST /v2/messages.

    Headers

    NameTypeConstraintsDescription
    Idempotency-KeyoptionalTypestringConstraints≤ 191 charsDescriptionYour unique id for this operation (≤ 191 visible ASCII). A retry with the same key and body returns the first answer with Idempotent-Replayed: true — it never runs twice. Kept 24 h.
    X-Request-IdoptionalTypestringConstraints—DescriptionOptional: your own request id, echoed back (otherwise we generate req_…). Quote it to support.

    Body

    NameTypeConstraintsDescription
    textrequiredTypestringConstraints—DescriptionThe new text (your own text messages, ≤ 15 minutes old). Content rules are checked again.
    numberIdoptionalTypestringConstraints—DescriptionOnly for messages not sent through v2 (otherwise the ledger knows the number).

    Request

    curl -X PATCH "https://mursilat.com/api/v2/messages/3EB0A1B2C3D4E5F60718" \
      -H "Authorization: Bearer $WASLA_API_KEY" \
      -H "Idempotency-Key: order-1042-confirm" \
      -H "Content-Type: application/json" \
      -d '{
      "text": "الموعد اتغير لـ 5 مساءً"
    }'
    Request — JSON
    {
      "text": "الموعد اتغير لـ 5 مساءً"
    }

    Response

    200Example

    200 — application/json
    {
      "messageId": "3EB0A1B2C3D4E5F60718",
      "action": "edit"
    }

    Response schema

    Fields of the example answer. Expand objects and arrays.

    • responseobject2 fields
      • messageIdstring "3EB0A1B2C3D4E5F60718"
      • actionstring "edit"

    Errors

    Besides the authentication, rate-limit and validation errors every endpoint can return:

    Errors →

    Number Shield & behaviour

    The new text passes the content rules again.

    Try it

    Send this request from your browser to the Mursilat API.

    documented example

    Preview — this copy of the docs isn’t on mursilat.com, so the console shows the documented example instead of calling the API.

    Real requests use your real number and plan: they can send WhatsApp messages, spend quota and delete data. (sends messages)

    Kept only in this tab’s memory: never saved, never put in the URL, sent only to mursilat.com. Reloading the page forgets it.

    Path parameters

    Send this request for real?

    This will send a real WhatsApp message (or campaign / code) from your number and use your plan quota.

    PATCH /v2/messages/{messageId}