Registry / http-networking / conductorone-sdk-typescript

conductorone-sdk-typescript

library1.1.1jsnpmunverified

The `conductorone-sdk-typescript` package provides a developer-friendly and type-safe TypeScript SDK for interacting with the ConductorOne API. Currently at version 1.1.1 (released October 2025), this SDK is regularly updated with a frequent release cadence, often driven by the Speakeasy CLI based on changes in the underlying ConductorOne API. Key differentiators include its strong TypeScript typing, ensuring compile-time safety and improved developer experience, and its full support for both CommonJS and ES Modules environments. It encapsulates the HTTP API for managing ConductorOne resources, offering structured access to various API operations such as managing app resource owners, entitlements, and automations, as evidenced by recent additions in `v1.1.1` and `v1.0.2`.

http-networking auth-security devops

npm install conductorone-sdk-typescript

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CONDUCTORONE-SDK-T

conductorone-sdk-typescript

http-networkingjavascriptv1.1.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ConductoroneSDKTypescript

✓ import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript";

✗ const ConductoroneSDKTypescript = require("conductorone-sdk-typescript");

The main SDK client class. Supports both CommonJS and ES Modules environments. For CommonJS, use `const { ConductoroneSDKTypescript } = require('conductorone-sdk-typescript');`.

operations (namespace)

✓ import * as operations from "conductorone-sdk-typescript/models/operations";

Access specific operation request and response types, e.g., `operations.CreateMonitorRequest` or `operations.CreateMonitorResponse`. The exact path might vary slightly depending on the SDK generation.

shared (namespace)

✓ import * as shared from "conductorone-sdk-typescript/models/shared";

Import shared data models and types used across multiple API operations, e.g., `shared.App` or `shared.Pagination`.

This example initializes the ConductorOne SDK client with authentication and then makes an API call to create a monitor for access conflicts, logging the result.

import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript"; const conductoroneSDKTypescript = new ConductoroneSDKTypescript({ security: { bearerAuth: process.env.CONDUCTORONE_BEARER_TOKEN ?? "", oauth: process.env.CONDUCTORONE_OAUTH_TOKEN ?? "", }, }); async function run() { try { const result = await conductoroneSDKTypescript.accessConflict.createMonitor(); console.log(result); } catch (error) { console.error("Error making API call:", error); } } run();

Debug

Known issues

gotchaA peer dependency on `react` is declared, which might be unexpected for a backend API client. If you encounter issues in a React context or bundling errors, ensure `react` is installed in your project.

fix

If working in a React environment, add `react` to your project dependencies: `npm install react` or `yarn add react`.

affects: >=0.0.1

breakingAs an SDK generated by Speakeasy CLI, minor versions (e.g., from 1.0.x to 1.1.x) may introduce breaking changes to API models, request/response structures, or method signatures if the underlying ConductorOne API contract evolves. Always review changelogs.

fix

Consult the official changelog for `conductorone-sdk-typescript` and the ConductorOne API documentation for specific version migration guides before upgrading non-patch versions.

affects: >=0.0.1

gotchaHandling of authentication (Bearer Token or OAuth2) requires providing credentials during SDK initialization. Failure to do so will result in unauthorized API calls (e.g., 401 status codes).

fix

Ensure the `security` object with a valid `bearerAuth` token or `oauth` token is passed to the `ConductoroneSDKTypescript` constructor during initialization.

affects: >=0.0.1

Errors

Common errors & fixes

Cannot find module 'conductorone-sdk-typescript' or its corresponding type declarations.

The package is not installed, or the import path is incorrect, or TypeScript cannot find declaration files.

fix

Install the package: `npm install conductorone-sdk-typescript`. Verify the import statement: `import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript";`.

TypeError: Cannot read properties of undefined (reading 'createMonitor') at ConductoroneSDKTypescript.accessConflict

The SDK client instance (`conductoroneSDKTypescript`) was not properly initialized, or the `security` configuration was invalid, leading to a non-functional client object.

fix

Ensure the `ConductoroneSDKTypescript` class is correctly instantiated with all required `security` parameters, e.g., `new ConductoroneSDKTypescript({ security: { bearerAuth: 'YOUR_TOKEN' } })`.

Error: Request failed with status code 401: Unauthorized

The provided authentication credentials (Bearer token or OAuth token) are either missing, expired, or invalid.

fix

Verify that the `bearerAuth` or `oauth` token supplied during SDK initialization is correct, active, and has the necessary permissions for the API call.

Upgrade

Version history

1.1.1latest on npm

Audit

Dependencies

reactoptionalDeclared as a peer dependency, though its direct usage in the SDK's core functionality is not immediately apparent from the README. Often indicates a wrapper or utility intended for React environments.

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/ConductorOne/conductorone-sdk-typescript ↗

packagehttps://www.npmjs.com/package/conductorone-sdk-typescript ↗

homepagehttps://conductorone.com ↗