Create Past Grants

Search Past Grants

post/api/v1/search/past-grants

Invokes the c1.api.app.v1.AppEntitlementUserBindingService.SearchPastGrants method.

Body Parameters

appEntitlementRefsarray of idstringappIdstringAppEntitlementRef

optional

The appEntitlementRefs field.

appIdsarray of string

optional

The appIds field.

appUserRefsarray of idstringappIdstringAppUserRef

optional

The appUserRefs field.

expandMaskpathsarray of stringAppEntitlementUserBindingExpandHistoryMask

optional

The AppEntitlementUserBindingExpandHistoryMask message.

pageSizenumber

optional

The pageSize field.

formatint32

pageTokenstring

optional

The pageToken field.

Returns

expandedarray of object

optional

The expanded field.

Hide ParametersShow Parameters

@typestring

optional

The type of the serialized message.

listarray of object

optional

The list of results containing up to X results, where X is the page size defined in the request.

Hide ParametersShow Parameters

appPathstring

optional

The appPath field.

appUserPathstring

optional

The appUserPath field.

entitlementPathstring

optional

The entitlementPath field.

historyobject

optional

The AppEntitlementUserBindingHistory message.

Hide ParametersShow Parameters

appEntitlementIdstring

optional

The ID of the app entitlement that the app user has access to

appIdstring

optional

The ID of the app associated with the app entitlement

appUserIdstring

optional

The ID of the app user that has access to the app entitlement

grantedAtstring

optional

formatdate-time

revokedAtstring

optional

formatdate-time

nextPageTokenstring

optional

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.

Request example cURL

curl https://{tenantDomain}.conductor.one/api/v1/search/past-grants \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CONDUCTORONE_SDK_API_KEY"

200 Example

{
  "expanded": [
    {
      "@type": "@type"
    }
  ],
  "list": [
    {
      "appPath": "appPath",
      "appUserPath": "appUserPath",
      "entitlementPath": "entitlementPath",
      "history": {
        "appEntitlementId": "appEntitlementId",
        "appId": "appId",
        "appUserId": "appUserId"
      }
    }
  ],
  "nextPageToken": "nextPageToken"
}