Create Personal Clients

NOTE: Searches personal clients for all users

client.Search.IAM.NewPersonalClients(ctx, body) (*ListarrayNextPageTokenstringSearchIAMNewPersonalClientsResponse, error)

post/api/v1/search/iam/personal_clients

Invokes the c1.api.iam.v1.PersonalClientSearchService.Search method.

Parameters

bodyPageSizefieldPageTokenfieldQueryfieldUsersfieldSearchIAMNewPersonalClientsParams

Hide ParametersShow Parameters

PageSizefield

optional

param.Field[int64]

The pageSize field.

formatint32

PageTokenfield

optional

param.Field[string]

The pageToken field.

Queryfield

optional

param.Field[string]

The query field.

Usersfield

optional

param.Field[[]IDstringUserRef]

The users field.

Hide ParametersShow Parameters

IDstring

optional

The id of the user.

Returns

SearchIAMNewPersonalClientsResponsestruct

The PersonalClientSearchServiceSearchResponse message.

Hide ParametersShow Parameters

Listarray

optional

[]IDstringAllowSourceCidrarrayClientIDstringCreatedAtTimeDeletedAtTimeDisplayNamestringExpiresTimeTimeLastUsedAtTimeScopedRolesarrayUpdatedAtTimeUserIDstringPersonalClient

The list field.

Hide ParametersShow Parameters

IDstring

optional

The unique ID of the personal client credential.

AllowSourceCidrarray

optional

[]string

If set, only allows the CIDRs in the array to use the credential.

ClientIDstring

optional

The clientID of the credential.

CreatedAtTime

optional

formatdate-time

DeletedAtTime

optional

formatdate-time

DisplayNamestring

optional

The display name of the personal client credential.

ExpiresTimeTime

optional

formatdate-time

LastUsedAtTime

optional

formatdate-time

ScopedRolesarray

optional

[]string

scoped_roles provides a list of IAM Roles that this OAuth2 Client's API permissions are reduced to. The permissions granted to OAuth2 Client are AND'ed against the owning User's own permissions.

UpdatedAtTime

optional

formatdate-time

UserIDstring

optional

The ID of the user that this credential is created for.

NextPageTokenstring

optional

The nextPageToken field.

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.IAM.NewPersonalClients(context.TODO(), conductoronesdk.SearchIAMNewPersonalClientsParams{

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

200 Example

{
  "list": [
    {
      "allowSourceCidr": [
        "string"
      ],
      "displayName": "displayName",
      "expiresTime": "2019-12-27T18:11:19.117Z",
      "scopedRoles": [
        "string"
      ]
    }
  ],
  "nextPageToken": "nextPageToken"
}