Messages

Batch get message contents

Changed on

Get the contents of multiple messages in a single request.

get/v1/messages/batch/content

Request

  • Base URL: https://api.knock.app
  • URL: https://api.knock.app/v1/messages/batch/content
  • Auth: HTTP bearer

Query parameters

message_idsstring[] required

The IDs of the messages to fetch contents of.

Response

OK

__typenamestring required

The typename of the schema.

inserted_atstring date-time required

Timestamp when the message content was created.

message_idstring required

The unique identifier for the message content.

Example response

[
  {
    "__typename": "MessageContent",
    "data": {
      "__typename": "MessageSmsContent",
      "body": "URGENT: Power failure detected in perimeter fencing. Backup generators failed to engage. Technical team dispatched. Maintain lockdown protocols.",
      "to": "+15553982647"
    },
    "inserted_at": "1993-06-11T20:30:00Z",
    "message_id": "2w3YUpTTOxuDvZFji8OMsKrG176"
  }
]

Changes

  • de4604427056Revision changes
    • breaking

      added the new required query request parameter message_ids

    • warning

      deleted the query request parameter message_ids[]