conductorone-api

SDK Installation

go get github.com/ConductorOne/conductorone-sdk-go

SDK Example Usage

Example

package main

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

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

	s := NewWithCredentials(ctx, &ClientCredentials{
		ClientID:     "",
		ClientSecret: "",
	} )

	res, err := s.Apps.Create(ctx, &shared.CreateAppRequest{
		Owners: []string{
			"string",
		},
	})
	if err != nil {
		log.Fatal(err)
	}

	if res.CreateAppResponse != nil {
		// handle response
	}
}

Available Resources and Operations

Apps

• Create - Create
• Delete - Delete
• Get - Get
• List - List
• Update - Update

Connector

• Create - Create
• CreateDelegated - Create Delegated
• Delete - Delete
• ForceSync - Force Sync
• Get - Get
• GetCredentials - Get Credentials
• List - List
• RevokeCredential - Revoke Credential
• RotateCredential - Rotate Credential
• Update - Update
• UpdateDelegated - Update Delegated

AppEntitlements

• Get - Get
• List - List
• ListForAppResource - List For App Resource
• ListForAppUser - List For App User
• ListUsers - List Users
• Update - Update

AppEntitlementUserBinding

• ListAppUsersForIdentityWithGrant - List App Users For Identity With Grant

AppEntitlementOwners

• Add - Add
• List - List
• Remove - Remove
• Set - Set

AppOwners

• Add - Add
• List - List
• Remove - Remove
• Set - Set

AppReport

• List - List

AppReportAction

• GenerateReport - Generate Report

AppResourceType

• Get - Get
• List - List

AppResource

• Get - Get
• List - List

AppResourceOwners

• List - List

AppUsageControls

• Get - Get
• Update - Update

AppUser

• Update - Update

Attributes

• CreateAttributeValue - Create Attribute Value
• DeleteAttributeValue - Delete Attribute Value
• GetAttributeValue - Get Attribute Value
• ListAttributeTypes - List Attribute Types
• ListAttributeValues - List Attribute Values

Auth

• Introspect - Introspect

RequestCatalogManagement

• AddAccessEntitlements - Add Access Entitlements
• AddAppEntitlements - Add App Entitlements
• Create - Create
• Delete - Delete
• Get - Get
• List - List
• ListEntitlementsForAccess - List Entitlements For Access
• ListEntitlementsPerCatalog - List Entitlements Per Catalog
• RemoveAccessEntitlements - Remove Access Entitlements
• RemoveAppEntitlements - Remove App Entitlements
• Update - Update

Directory

• Create - Create
• Delete - Delete
• Get - Get
• List - List

PersonalClient

• Create - Create

Roles

• Get - Get
• List - List
• Update - Update

Policies

• Create - Create
• Delete - Delete
• Get - Get
• List - List
• Update - Update

PolicyValidate

• ValidateCEL - Validate Cel

AppResourceSearch

• SearchAppResourceTypes - Search App Resource Types

AppSearch

• Search - Search

AttributeSearch

• SearchAttributeValues - Search Attribute Values

AppEntitlementSearch

• Search - Search

PolicySearch

• Search - Search

RequestCatalogSearch

• SearchEntitlements - Search Entitlements

TaskSearch

• Search - Search

UserSearch

• Search - Search

AWSExternalIDSettings

• Get - Get

SessionSettings

• Get - Get
• Update - Update

Task

• CreateGrantTask - Create Grant Task
• CreateRevokeTask - Create Revoke Task
• Get - Get

TaskActions

• Approve - Approve
• Comment - Comment
• Deny - Deny
• EscalateToEmergencyAccess - Escalate To Emergency Access
• Restart - Restart

User

• Get - Get
• List - List

Webhooks

• Test - Test

Error Handling

Handling errors in this SDK should largely match your expectations. All operations return a response object or an error, they will never return both. When specified by the OpenAPI spec document, the SDK will return the appropriate subclass.

Error Object	Status Code	Content Type
sdkerrors.SDKError	400-600	/

Example

package main

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

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

	s := NewWithCredentials(ctx, &ClientCredentials{
		ClientID:     "",
		ClientSecret: "",
	})
	res, err := s.Apps.Create(ctx, &shared.CreateAppRequest{
		Owners: []string{
			"string",
		},
	})
	if err != nil {

		var e *sdkerrors.SDKError
		if errors.As(err, &e) {
			// handle error
			log.Fatal(e.Error())
		}
	}
}

SDK Example Usage with Custom Server/Tenant

Example

package main

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

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

	/* Optional Override 
	* Server URL will be extracted from client, optionally, you can
	* provide a server URL or a tenant domain (will create URL https://{tenant_domain}.conductor.one) 
	*/
	opts := []sdk.CustomSDKOption{}
	opt, _ := sdk.WithTenantCustom("Server URL or Tenant Domain")
	opts = append(opts, opt)

	s := NewWithCredentials(ctx, &ClientCredentials{
		ClientID:     "",
		ClientSecret: "",
	} opts...)

	res, err := s.Apps.Create(ctx, &shared.CreateAppRequest{
		Owners: []string{
			"string",
		},
	})
	if err != nil {
		log.Fatal(err)
	}

	if res.CreateAppResponse != nil {
		// handle response
	}
}

Maturity

This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally looking for the latest version.

Contributions

While we value open-source contributions to this SDK, this library is generated programmatically. Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release !

SDK Created by Speakeasy