PUT/notifications/{id}

Replace notification

Full replacement. All mutable fields overwritten. Triggers `notifications.updated` webhook.

Parameters 1

Name	Type	Description
idrequired	path · integer	Resource identifier

ReturnsNotification

AcceptsNotificationInput

Bearer token required

Response examples

200Notification replaced

application/json example derived from schema

{
  "id": 1,
  "userId": 1,
  "type": "error",
  "title": "Error notification",
  "message": "New follower on your profile.",
  "read": true,
  "link": null,
  "createdAt": "2026-03-23T15:22:15.402Z"
}

400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}

404404 — resource not found

application/json

{
  "error": {
    "status": 404,
    "message": "users #999 not found"
  }
}

Try ItMock API v2.0.1

Code examples

curl -X PUT -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "userId": 1,
  "type": "info",
  "title": "New feature available",
  "message": "Batch operations are now live — run up to 20 writes in one call.",
  "link": "/guide/batch"
}' 'https://api.rodin.dev/mock/notifications/{id}'

fetch("https://api.rodin.dev/mock/notifications/{id}", {
  method: "PUT",
  headers: {
      "Authorization": "Bearer <TOKEN>",
      "Content-Type": "application/json"
    },
  body: "{\n  \"userId\": 1,\n  \"type\": \"info\",\n  \"title\": \"New feature available\",\n  \"message\": \"Batch operations are now live — run up to 20 writes in one call.\",\n  \"link\": \"/guide/batch\"\n}",
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/notifications/{id}"
headers = {
    "Authorization": "Bearer <TOKEN>",
    "Content-Type": "application/json"
}
data = "{\n  \"userId\": 1,\n  \"type\": \"info\",\n  \"title\": \"New feature available\",\n  \"message\": \"Batch operations are now live — run up to 20 writes in one call.\",\n  \"link\": \"/guide/batch\"\n}"

response = requests.put(url, headers=headers, data=data)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL

Server:

https://api.rodin.dev/mockhttp://localhost:3002

Body:

{ "userId": 1, "type": "info", "title": "New feature available", "message": "Batch operations are now live — run up to 20 writes in one call.", "link": "/guide/batch" }