Notifications

Reads a notification

Changed on

Mark a notification as read.

patch/api/v2/notifications/{id}/read

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/notifications/{id}/read
  • Auth
    none declared

Path parameters

idstring required

ID

Response

Single notification

Example response

{
  "data": {
    "id": "9012",
    "type": "notifications",
    "attributes": {
      "target_id": 120501,
      "target_type": "task",
      "target_title": "#42: Implement user authentication",
      "target_label": "task",
      "parent_id": 6899,
      "parent_type": "project",
      "parent_title": "Website Redesign",
      "title": "Alex Smith changed the status to In Progress",
      "read": false,
      "dismissed": false,
      "new_activities_count": 1,
      "excerpt": "Status changed from Open to In Progress",
      "last_action_at": "2026-03-15T10:30:00.000+00:00",
      "first_unread_activity_id": 259275372,
      "important": false,
      "mention": false,
      "made_by_automation": false,
      "root_id": 6899,
      "root_type": "project"
    },
    "relationships": {
      "actor": {
        "data": {
          "type": "people",
          "id": "12"
        }
      }
    }
  },
  "included": []
}

Changes

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • breaking

      response property data/attributes/parent_id list-of-types was widened by adding types null and string to media type application/vnd.api+json of response 200

    • breaking

      the // response's property type changed from integer to no type for status

    • breaking

      the // response's property type changed from string to no type, and format from date-time to no format for status

    • breaking

      the // response's property type changed from integer to no type for status

    • warning

      deleted the header request parameter X-Organization-Id

    • info

      added the optional property // to the response with the status

    • info

      added to the // response property anyOf list for the response status

    • info

      added to the // response property anyOf list for the response status

    • info

      added to the // response property anyOf list for the response status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      added subschema #2 to the // response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the // response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the // response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the // response property anyOf list for the response status

    • info

      the response property //// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property //// became required for the status

    • info

      the response property ///// became required for the status

    This list may be incomplete.