List Bindings

ListBindings returns every active binding held by a subject. Empty list when the subject is unbound. The response is unordered.

POST /api/v1/service_principals/bindings/list

ListBindings

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.Principal.ListBindings(ctx, nil)
    if err != nil {
        log.Fatal(err)
    }
    if res.ServicePrincipalServiceListBindingsResponse != nil {
        // handle response
    }
}

200

{
  "bindings": [
    {
      "createdAt": "2023-11-07T05:31:56Z",
      "servicePrincipalId": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "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

The ServicePrincipalServiceListBindingsRequest message.

pageSize · integer<int32>

The pageSize field.

pageToken · string

The pageToken field.

subject · Service Principal Binding Subject · object

ServicePrincipalBindingSubject identifies the entity that is bound to a service principal. Open-ended oneof so future subject kinds (workflows, connectors, etc.) can be added without changing the RPC shape.

This message contains a oneof named kind. Only a single field of the following list may be set at a time:

• functionId

Show child attributes

Response

200 - application/json

Successful response

The ServicePrincipalServiceListBindingsResponse message.

bindings · Service Principal Binding · object[] | null

Active bindings held by the subject in this page. Empty when the subject is unbound. Order is unspecified.

Show child attributes

nextPageToken · string

The nextPageToken field.