Documents

Read documents by facets

Changed on Oct 5, 2026

Read the documents including metadata (does not include enhanced metadata via /documentmetadata) macthing the given facet conditions.

post/rest/api/v1/getdocumentsbyfacets

Request

Base URL: https://instance-name-be.glean.com
URL: https://instance-name-be.glean.com/rest/api/v1/getdocumentsbyfacets
Auth: HTTP bearer

Query parameters

localestring

The client's preferred locale in rfc5646 format (e.g. en, ja, pt-BR). If omitted, the Accept-Language will be used. If not present or not supported, defaults to the closest match or en.

Headers

X-Glean-ActAsstring email

Email address of a user on whose behalf the request is intended to be made (should be non-empty only for global tokens).

X-Glean-Auth-Typestring

Auth type being used to access the endpoint (should be non-empty only for global tokens).

Request body

datasourcesFilterstring[]

Filter results to one or more datasources (e.g. gmail, slack). All results are returned if missing.

cursorstring

Pagination cursor. A previously received opaque token representing the position in the overall results at which to start.

Example request

{
  "filterSets": [
    {
      "filters": [
        {
          "fieldName": "type",
          "values": [
            {
              "value": "Spreadsheet",
              "relationType": "EQUALS"
            },
            {
              "value": "Presentation",
              "relationType": "EQUALS"
            }
          ]
        }
      ]
    }
  ]
}

Response

hasMoreResultsboolean

Whether more results are available. Use cursor to retrieve them.

cursorstring

Cursor that indicates the start of the next page of results. To be passed in "more" requests for this query.

Example response

{
  "documents": [
    {
      "metadata": {
        "container": "container",
        "parentId": "JIRA_EN-1337",
        "createTime": "2000-01-23T04:56:07.000Z",
        "datasource": "datasource",
        "author": {
          "name": "name"
        },
        "documentId": "documentId",
        "updateTime": "2000-01-23T04:56:07.000Z",
        "mimeType": "mimeType",
        "objectType": "Feature Request",
        "components": [
          "Backend",
          "Networking"
        ],
        "status": "Done",
        "customData": {
          "someCustomField": {
            "stringValue": "someCustomValue"
          }
        }
      }
    }
  ]
}

Changes

Oct 5, 2026cfa377371200 Revision changes
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property /////// to the response with the status
Oct 2, 20263c36e7c6aa0c Revision changes
- warning
  added the new VIDEO_TYPE enum value to the ///////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the //////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the /////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the //////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the //////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ////////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ////////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the //////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the /////////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the //////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the //////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the /////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the /////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the /////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the /////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ////////////////// response property for the response status
- warning
  added the new VIDEO_TYPE enum value to the ///////////// response property for the response status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property //// to the response with the status

Operation history (6 revisions)