COconductorone
App Entitlement User Binding History

Search Past Grants

Changed on

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

post/api/v1/search/past-grants

Request

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/search/past-grants
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

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

  • f2cf3228f366Revision changes
    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property became not nullable

    • breaking

      the request property type changed from object to no type

    • breaking

      added subschema #2 to the // response property oneOf list for the response status

    • breaking

      the // response's property type changed from object to no type for status

    • warning

      removed the request property /

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • warning

      removed the optional property /// from the response with the status

    • info

      added subschema #2 to the request property oneOf list

  • d5c56e8615feRevision changes
    • info

      added the new optional request property