Delete Binding

DeleteBinding removes a single (subject, service_principal_id) binding row. At-most-one delete — does not touch other bindings the subject may hold against different service principals. Idempotent — succeeds even if no matching row exists.

POST /api/v1/service_principals/bindings/delete

DeleteBinding

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

200

{}

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 ServicePrincipalServiceDeleteBindingRequest message.

servicePrincipalId · string

The servicePrincipalId 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 ServicePrincipalServiceDeleteBindingResponse message.