Search User Ownership

Search all ownership assignments for a given user across apps, resources, and entitlements.

POST /api/v1/search/user-ownership

SearchUserOwnership

Go

package main

import(
	"context"
	"github.com/conductorone/conductorone-sdk-go/pkg/models/shared"
	conductoronesdkgo "github.com/conductorone/conductorone-sdk-go"
	"log"
)

func main() {
    ctx := context.Background()

    s := conductoronesdkgo.New(
        conductoronesdkgo.WithSecurity(shared.Security{
            BearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
            Oauth: "<YOUR_OAUTH_HERE>",
        }),
    )

    res, err := s.AppSearch.SearchUserOwnership(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.SearchUserOwnershipResponse != nil {
        // handle response
    }
}

200

{
  "list": [
    {
      "appDisplayName": "<string>",
      "appId": "<string>",
      "entitlementDisplayName": "<string>",
      "entitlementId": "<string>",
      "ownershipType": "USER_OWNERSHIP_TYPE_UNSPECIFIED",
      "resourceDisplayName": "<string>",
      "resourceId": "<string>",
      "resourceTypeId": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization · string · header · required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Body

application/json

Search for all ownership assignments for a given user. Returns apps, resources, and entitlements the user owns, each tagged with a UserOwnershipType discriminator. Filter by ownership_types to restrict results to specific kinds of ownership.

ownershipTypes · enum<string>[] | null

Filter results to only include these ownership types. If empty, all types are returned.

Available options: USER_OWNERSHIP_TYPE_UNSPECIFIED, USER_OWNERSHIP_TYPE_APP, USER_OWNERSHIP_TYPE_RESOURCE, USER_OWNERSHIP_TYPE_ENTITLEMENT

pageSize · integer<int32>

Maximum number of results to return per page.

pageToken · string

Pagination token from a previous response.

userId · string

The ID of the ConductorOne user whose ownership to search.

Response

200 - application/json

The SearchUserOwnershipResponse message contains a paginated list of ownership entries.

The SearchUserOwnershipResponse message contains a paginated list of ownership entries.

list · User Ownership Entry · object[] | null

The list of ownership entries for the requested user.

Show child attributes

nextPageToken · string

Pagination token for the next page of results. Empty when there are no more results.