Create Past Grants

Search Past Grants

client.Search.NewPastGrants(ctx, body) (*ExpandedarrayListarrayNextPageTokenstringSearchNewPastGrantsResponse, error)

post/api/v1/search/past-grants

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

Parameters

bodyAppEntitlementRefsfieldAppIDsfieldAppUserRefsfieldExpandMaskfieldPageSizefieldPageTokenfieldSearchNewPastGrantsParams

Hide ParametersShow Parameters

AppEntitlementRefsfield

optional

param.Field[[]IDstringAppIDstringAppEntitlementRef]

The appEntitlementRefs field.

Hide ParametersShow Parameters

IDstring

optional

The id field.

AppIDstring

optional

The appId field.

AppIDsfield

optional

param.Field[[]string]

The appIds field.

AppUserRefsfield

optional

param.Field[[]IDstringAppIDstringAppUserRef]

The appUserRefs field.

Hide ParametersShow Parameters

IDstring

optional

The ID of the app user.

AppIDstring

optional

The ID of the application.

ExpandMaskfield

optional

param.Field[PathsarrayAppEntitlementUserBindingExpandHistoryMask]

The AppEntitlementUserBindingExpandHistoryMask message.

PageSizefield

optional

param.Field[int64]

The pageSize field.

formatint32

PageTokenfield

optional

param.Field[string]

The pageToken field.

Returns

SearchNewPastGrantsResponsestruct

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

Hide ParametersShow Parameters

Expandedarray

optional

[]SearchNewPastGrantsResponseExpanded

The expanded field.

Hide ParametersShow Parameters

Typestring

optional

The type of the serialized message.

Listarray

optional

[]SearchNewPastGrantsResponseList

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.

HistoryAppEntitlementIDstringAppIDstringAppUserIDstringGrantedAtTimeRevokedAtTimeSearchNewPastGrantsResponseListHistory

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

GrantedAtTime

optional

formatdate-time

RevokedAtTime

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 Go

package main

import (
  "context"
  "fmt"

  "github.com/stainless-sdks/-go"
  "github.com/stainless-sdks/-go/option"
)

func main() {
  client := conductoronesdk.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.Search.NewPastGrants(context.TODO(), conductoronesdk.SearchNewPastGrantsParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Expanded)
}

200 Example

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