@theholocron/sentry-client

TypeScript client for the Sentry management API.

This is the management API client for provisioning Sentry projects and retrieving DSNs — not the error-capture SDK. For runtime error reporting use @sentry/node directly.

Install

pnpm add @theholocron/sentry-client

Usage

import { createSentryClient } from "@theholocron/sentry-client";

const sentry = createSentryClient({ token: process.env.SENTRY_AUTH_TOKEN! });

// List accessible organizations (also useful for token verification)
const orgs = await sentry.auth.organizations();

// Get a specific organization
const org = await sentry.auth.getOrg("my-org");

// List projects in an org
const projects = await sentry.projects.list("my-org");

// Get a project by slug
const project = await sentry.projects.get("my-org", "my-project");

// Create a project under a team
const newProject = await sentry.projects.create("my-org", "my-team", {
  name: "my-project",
  platform: "node",
});

// Retrieve client keys (DSNs) for a project
const keys = await sentry.projects.keys("my-org", newProject.slug);
const dsn = keys[0].dsn.public;

Auth

Generate an auth token with the required scopes:

| Operation | Required scopes | | ------------------------ | --------------- | | List orgs / verify token | org:read | | List / get projects | project:read | | Create projects | project:write |

The token is passed directly or read from SENTRY_AUTH_TOKEN.

Note: This is a user-scoped or org-scoped auth token, not the project-level DSN token your app embeds at runtime. Those are outputs of projects.keys(), not inputs to this client.