v4

latestSwagger 2.02026-08-0343714211.7 MB

messages

Messages

List Messages

get/messages

Query parameters

user_idinteger

User ID. Provide a value of 0 to operate the current session's user.

cursorstring

Used for pagination. When a list request has more records available, cursors are provided in the response headers X-Files-Cursor-Next and X-Files-Cursor-Prev. Send one of those cursor value here to resume an existing list from the next available record. Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.

per_pageinteger

Number of records to show per page. (Max: 10000, 1,000 or less is recommended).

project_idinteger required

Project for which to return messages.

Response

A list of Messages objects.

idinteger

Message ID

subjectstring

Message subject.

bodystring

Message body.

Example response

[
  {
    "id": 1,
    "subject": "Files.com Account Upgrade",
    "body": "We should upgrade our Files.com account!",
    "comments": [
      {
        "id": 1,
        "body": "What a great idea, thank you!",
        "reactions": [
          {
            "id": 1,
            "emoji": "👍"
          }
        ]
      }
    ]
  }
]