Messages

Mark message as read

Marks a message as read. This indicates that the user has read the message content. Read more about message engagement statuses here.

put/v1/messages/{message_id}/read

Path parameters

message_idstring required

The unique identifier for the message.

Response

__typenamestring required

The typename of the schema.

archived_atstring date-time nullable

Timestamp when the message was archived.

channel_idstring uuid required

Deprecated, use channel.id instead.

clicked_atstring date-time nullable

Timestamp when the message was clicked.

dataobject nullable

Data associated with the message’s workflow run. Includes the workflow trigger request’s data payload merged with any additional data returned by a fetch function. For messages produced after a batch step, includes the payload data from the most-recent trigger request (the final activity in the batch).

engagement_statusesstring[] required

A list of engagement statuses.

idstring required

The unique identifier for the message.

inserted_atstring date-time required

Timestamp when the resource was created.

interacted_atstring date-time nullable

Timestamp when the message was interacted with.

link_clicked_atstring date-time nullable

Timestamp when a link in the message was clicked.

metadataobject nullable

The metadata associated with the message.

read_atstring date-time nullable

Timestamp when the message was read.

scheduled_atstring date-time nullable

Timestamp when the message was scheduled to be sent.

seen_atstring date-time nullable

Timestamp when the message was seen.

The message delivery status.

tenantstring nullable

The ID of the tenant associated with the message. Only present when a tenant is provided on a workflow trigger request.

updated_atstring date-time required

The timestamp when the resource was last updated.

workflowstring nullable

The key of the workflow that generated the message.

Example response

{
  "__typename": "Message",
  "actors": [
    "mr_arnold",
    "mr_muldoon"
  ],
  "archived_at": null,
  "channel_id": "123e4567-e89b-12d3-a456-426614174000",
  "clicked_at": null,
  "data": {
    "affected_areas": [
      "visitor_center",
      "raptor_pen",
      "trex_paddock"
    ],
    "attraction_id": "paddock_rex_01",
    "evacuation_protocol": "active",
    "message": "Life finds a way",
    "severity": "critical",
    "system_status": "fences_failing"
  },
  "engagement_statuses": [
    "read",
    "seen"
  ],
  "id": "2w3YUpTTOxuDvZFji8OMsKrG176",
  "inserted_at": "1993-06-11T21:15:00Z",
  "interacted_at": null,
  "link_clicked_at": null,
  "metadata": {
    "external_id": "123e4567-e89b-12d3-a456-426614174000"
  },
  "read_at": "1993-06-11T21:30:00Z",
  "recipient": "dr_grant",
  "scheduled_at": null,
  "seen_at": "1993-06-11T21:29:45Z",
  "source": {
    "__typename": "NotificationSource",
    "categories": [
      "security",
      "emergency"
    ],
    "key": "security-breach-alert",
    "step_ref": "alert_step_1",
    "version_id": "123e4567-e89b-12d3-a456-426614174000",
    "workflow_recipient_run_id": "def01234-a56b-78c9-d012-345678901bcd",
    "workflow_run_id": "789e0123-f45a-67b8-c901-234567890abc"
  },
  "status": "sent",
  "tenant": "ingen_isla_nublar",
  "updated_at": "1993-06-11T21:30:05Z",
  "workflow": "security-breach-alert"
}

Changes

Changed in 5 of the 30 revisions of this API.15

Dec 8, 2025b4f3f80942152See the full diff
- ○
  added the optional property allOf[subschema #1: Message]/source/workflow_recipient_run_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property allOf[subschema #1: Message]/source/workflow_run_id to the response with the 200 status
  response-optional-property-added
Oct 27, 202540ca41599f572See the full diff
- ○
  added the optional property allOf[subschema #1: Message]/channel to the response with the 200 status
  response-optional-property-added
- ○
  response property allOf[subschema #1: Message]/channel_id deprecated
  response-property-deprecated
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 7, 2025fe051300804a1See the full diff
- ○
  added the optional property allOf[subschema #1: Message]/source/type to the response with the 200 status
  response-optional-property-added
Aug 27, 2025de67f68640a09See the full diff
- ○
  the response property allOf[subschema #1: Message]/__typename became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/channel_id became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/engagement_statuses became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/id became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/inserted_at became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/recipient became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/source became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/status became required for the status 200
  response-property-became-required
- ○
  the response property allOf[subschema #1: Message]/updated_at became required for the status 200
  response-property-became-required
Jul 10, 2025592610bb4a051See the full diff
- ○
  added the optional property allOf[subschema #1: Message]/source/step_ref to the response with the 200 status
  response-optional-property-added

Full history