Return JSON object that lists messages based on advanced query filter parameters. Note: Use nextPageUrl and prevPageUrl from the response data for query pagination.

URL Parameters

NameDescriptionLocationRequiredDefault Value
spaceIdUnique identifier of the space.pathYes
refTimeUTC timestampqueryNocurrent timestamp
directionList messages 'before' or 'after' refTime.queryNoafter
category'chat', 'idea', or 'task'queryNo
parentmsg_category'none' (returns messages for chat only), 'idea', or 'task'queryNo'none'
file_only'yes', 'y', or 'true'. Returns only files of the messages.queryNo
chatmsg_only'yes', 'y', or 'true'. Returns chat text messages only.queryNo
searchstringSearch text to filter messages.queryNo
sizeNumber of messages to return.queryNo30 (max: 50)
pagerefReadonly. This parameter is not used by Spaces and is only a reference. i.e.: the value sent will be the same value returned.queryNo
nextRefObjIdMessageId of the next message.queryNo
prevRefObjIdMessageId of the previous message.queryNo

Body Parameters

None.

Authentication

JwtAuthenticator, Oauth2Authenticator, AnonymousAuthenticator

Authorization

PERM_TOPIC_READ

Example Request

URL

GET https://spacesapis.zang.io/api/spaces/{spaceId}/messages/query

Headers

Authorization: "jwt eyJhbGciOiJSUzI1NiIsIdfgdfgnR5cCI6IkpXVCJ9.eyJ1c2VyX2lkX3NpZyI6ImxPWHpxNzVzR3J3X0xwWEMyRGRMakhyYXJlWVhyTzFMdEZHZkhkOWNkTXciLCJwcm9kdWN0X3R5cGUiOiJhY2NvdW50cyIsImxhc3R1cGRhdGV0aW1lIjoiMjAxNy0wMS0zMFQxMzo1ODo0Ny4yMDYiLCJpc3MiOiJ6YW5nLmlvIiwicHVibGlja2V5aWQiOiJhZ3h6Zm05dVpYTnVZVEl3TVRSeUdnc1NEVWRLZDNSUWRXSnNhV05MWlhrdfgdWdJQ2dsUEtFakFvTSIsImV4cCI6MTQ5NTM5MTIwMywidXNlcl9pZCI6ImFneHpmbTl1WlhOdVlUSXdNVFJ5RVFzU0JGVnpaWElZZ0lEQXMtX25fUW9NIiwidmVyIjoiMi4wIn0.SqZpw1uPIebqW3qlDsm0-DWYFKEH0SgPwtD-tSESWOF-5hLkZMqJH28ooWux2S7s9riIew7pTVPnZpTgJa5zHcEAG0gXSEJVOqmpGp_4ufM8YtZoZMpBFjyAkwyAt-ILkGUYIo0GU5WyzMPLV8YLXfgdfgOgkE2MGGOajBkjPmC2Db3pA0D0M9k-21EL1gwWBC5YIq0PDAkgulegwl6khRmB8irJQ-dfg-d-KV9eYfFpsCdJKRGzSfqg"

Or

Authorization: "bearer f746696f5de4528u128ae2f274eea253e8a7943a"

Example Response

{
  "data": [
    {
      "_id": "58ed325779bf9c47479faf9b",
      "category": "chat",
      "topicId": "58c97998d56ed915c3d28e32",
      "modified": "2017-04-11T19:46:40.867Z",
      "content": {
        "bodyText": "",
        "description": "",
        "data": [
          {
            "provider": "native",
            "providerFileType": "",
            "fileType": "document",
            "name": "Angularjs.docx",
            "fileId": "7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59",
            "icon": "",
            "thumbnail": "",
            "keywords": "",
            "description": "",
            "previewFile": "",
            "fileSize": 238051,
            "thumbnailFile": "7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59_convert/thumbnail.jpg",
            "metaData": {
              "stgeProvd": "gcs",
              "prvwProvd": "gcs",
              "paging": 0
            },
            "pages": 17,
            "nextSchedule": null,
            "convertStart": null,
            "convertStatus": 2,
            "convertError": "",
            "path": "https://storage.googleapis.com/onesnatesting/logan%2F7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59?GoogleAccessId=logan-testing@onesnatesting.iam.gserviceaccount.com&Expires=1493401268&Signature=LlV4TqizeqYjWpmHyLumKa1YQU%2FmvYx9BwcCdxMlaE1Q4HH%2FRoJiwniZCvHnEpS7JkBlhSUxM%2BH9fPbFzw2Vnyfu94l8Zaf4YE%2BlsVZD7ujbXoYAUIU9G8LH4bdR9D5zhXfph3TmrJyWv9WYdVf%2FToLhd6XTAQeH5XMlZDThUjv1Z3rKJQxSxv04p%2BRTVuk4eX%2FnIEC33nTN2lNBTdehjU5xHM6qECbpHj6odw5tn%2B%2Ft3tazpd0LTOPyQ0DSFG2UbO1T8pqPpo3LZIjBf2%2BHFuCs04vAelfvwpOLApi1hjImZSoc1VSb9jhoyXTa0HKJcQnvM1FXt8tNGij6qvyzSQ%3D%3D&response-content-disposition=attachment%3B%20filename%3D%22Angularjs.docx%22",
            "previewUrl": "https://storage.googleapis.com/onesnatesting/logan%2F7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59_convert%2Fthumbnail.jpg?GoogleAccessId=logan-testing@onesnatesting.iam.gserviceaccount.com&Expires=1493401268&Signature=W%2BRm8d8zVRMvNDqKaeEaOk56jUAB0Wec8xaXehB8a%2F%2BkzvOixskJCBuGL5VT4mHi%2FhlV5jniwqJEY7EH86g45gbmzOY2HbZ1Bx5LKOBNi72Pld%2FfWgco3L9ZpUczCofIsvf6RDvo2kVmlsO3A%2FmofN4yF7m9cbTlh%2B3C%2BTYyyeDqdqvcfkvBxu3A71eb1wt6Vq0rki8JFN49K5UwJDdvSymzHvxRUyJKWYXufpZKXqBhDlWRCBauUfotWE95HqrA9sF2%2F4EY6bjmsB9m8UcIjHiTMUxKrDlVrLD2q0ArOAFWrSU9dGD09AaNuf7zLOAPogOTxNr3qURTapWAMbagPg%3D%3D",
            "thumbnailUrl": "https://storage.googleapis.com/onesnatesting/logan%2F7de9fe09-2b4e-4a6d-9bfd-a3c8e78a7d59_convert%2Fthumbnail.jpg?GoogleAccessId=logan-testing@onesnatesting.iam.gserviceaccount.com&Expires=1493401268&Signature=W%2BRm8d8zVRMvNDqKaeEaOk56jUAB0Wec8xaXehB8a%2F%2BkzvOixskJCBuGL5VT4mHi%2FhlV5jniwqJEY7EH86g45gbmzOY2HbZ1Bx5LKOBNi72Pld%2FfWgco3L9ZpUczCofIsvf6RDvo2kVmlsO3A%2FmofN4yF7m9cbTlh%2B3C%2BTYyyeDqdqvcfkvBxu3A71eb1wt6Vq0rki8JFN49K5UwJDdvSymzHvxRUyJKWYXufpZKXqBhDlWRCBauUfotWE95HqrA9sF2%2F4EY6bjmsB9m8UcIjHiTMUxKrDlVrLD2q0ArOAFWrSU9dGD09AaNuf7zLOAPogOTxNr3qURTapWAMbagPg%3D%3D"
          }
        ],
        "assignees": []
      },
      "created": "2017-04-11T19:45:27.163Z",
      "sender": {
        "_id": "5846cc603bab0e18ff03cca0",
        "type": "user",
        "username": "ericd@esna.com",
        "displayname": "ericd ding",
        "picture_url": "https://storage.googleapis.com/onesnatesting/pictures/pfpic_ericd_977ffaaf-6b90-4e08-acde-06c66955bef0"
      },
      "likeCount": 0,
      "chatCount": 0,
      "__v": 0
    }
  ],
  "nextPageUrl": "/api/spaces/58c97998d56ed915c3d28e32/messages/query?refTime=&direction=after&size=1&pageref=2&begObjectId=&category=&parentmsg_category=&file_only=&chatmsg_only=&searchstring=&nextRefObjId=58ed325779bf9c47479faf9b",
  "previousPageUrl": "",
  "total": 1
}