App Entitlement User Binding History

Search Past Grants

Search historical grants that have been revoked, filtered by app user or entitlement.

post/api/v1/search/past-grants

Request body

appIdsstring[] nullable

A list of app IDs to restrict the search to.

pageSizeinteger

The maximum number of results to return per page.

pageTokenstring

The token for fetching the next page of results.

Response

The SearchPastGrantsResponse message contains a list of past grants and a nextPageToken if applicable.

nextPageTokenstring

The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retrieved. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

Changes

Changed in 3 of the 33 revisions of this API.663

  • f2cf3228f366661See the full diff
    • the request property appEntitlementRefs became not nullable

      request-property-became-not-nullable

    • the request property appIds became not nullable

      request-property-became-not-nullable

    • the request property appUserRefs became not nullable

      request-property-became-not-nullable

    • the expandMask request property type/format changed from object/ to /

      request-property-type-changed

    • added c1.api.app.v1.AppEntitlementUserBindingHistory subschema #2 to the list/items/history response property oneOf list for the response status 200

      response-property-one-of-added

    • the list/items/history response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • removed the request property expandMask/paths

      request-property-removed

    • removed the optional property list/items/history/appEntitlementId from the response with the 200 status

      response-optional-property-removed

    • removed the optional property list/items/history/appId from the response with the 200 status

      response-optional-property-removed

    • removed the optional property list/items/history/appUserId from the response with the 200 status

      response-optional-property-removed

    • removed the optional property list/items/history/grantedAt from the response with the 200 status

      response-optional-property-removed

    • removed the optional property list/items/history/revokedAt from the response with the 200 status

      response-optional-property-removed

    • added c1.api.app.v1.AppEntitlementUserBindingExpandHistoryMask subschema #2 to the expandMask request property oneOf list

      request-property-one-of-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new optional request property appIds

      new-optional-request-property

    This revision also has 44 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • endpoint added

      endpoint-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog