Messages

Get message

Retrieves a specific message by its ID.

get/v1/messages/{message_id}

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 source/workflow_recipient_run_id to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property 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 channel to the response with the 200 status
  response-optional-property-added
- ○
  response property 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 source/type to the response with the 200 status
  response-optional-property-added
Aug 27, 2025de67f68640a09See the full diff
- ○
  the response property __typename became required for the status 200
  response-property-became-required
- ○
  the response property channel_id became required for the status 200
  response-property-became-required
- ○
  the response property engagement_statuses became required for the status 200
  response-property-became-required
- ○
  the response property id became required for the status 200
  response-property-became-required
- ○
  the response property inserted_at became required for the status 200
  response-property-became-required
- ○
  the response property recipient became required for the status 200
  response-property-became-required
- ○
  the response property source became required for the status 200
  response-property-became-required
- ○
  the response property status became required for the status 200
  response-property-became-required
- ○
  the response property updated_at became required for the status 200
  response-property-became-required
Jul 10, 2025592610bb4a051See the full diff
- ○
  added the optional property source/step_ref to the response with the 200 status
  response-optional-property-added

Full history