> ## Documentation Index
> Fetch the complete documentation index at: https://trigger.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Management API overview

> Using the Trigger.dev management API

## Installation

The management API is available through the same `@trigger.dev/sdk` package used in defining and triggering tasks. If you have already installed the package in your project, you can skip this step.

```bash npm theme={"theme":"css-variables"}
npm i @trigger.dev/sdk@latest
```

```bash pnpm theme={"theme":"css-variables"}
pnpm add @trigger.dev/sdk@latest
```

```bash yarn theme={"theme":"css-variables"}
yarn add @trigger.dev/sdk@latest
```

## Usage

All `v3` functionality is provided through the `@trigger.dev/sdk` module. You can import the entire module or individual resources as needed.

```ts theme={"theme":"css-variables"}
import { configure, runs } from "@trigger.dev/sdk";

configure({
  // this is the default and if the `TRIGGER_SECRET_KEY` environment variable is set, can omit calling configure
  accessToken: process.env["TRIGGER_SECRET_KEY"],
});

async function main() {
  const completedRuns = await runs.list({
    limit: 10,
    status: ["COMPLETED"],
  });
}

main().catch(console.error);
```

### Multiple clients in one process

If a single process needs to talk to more than one Trigger.dev project, environment, or preview branch, use `new TriggerClient({...})` for each target instead of `configure()`. Each instance owns its own auth and config, with no shared global state. See [Multiple SDK clients](https://trigger.dev/docs/management/multiple-clients.md) for the full pattern.

```ts theme={"theme":"css-variables"}
import { TriggerClient } from "@trigger.dev/sdk";

const prod = new TriggerClient({ accessToken: process.env.TRIGGER_PROD_KEY });
const preview = new TriggerClient({
  accessToken: process.env.TRIGGER_PREVIEW_KEY,
  previewBranch: "signup-flow",
});

const payload = { to: "user@example.com" };
await prod.tasks.trigger("send-email", payload);
await preview.runs.list({ status: ["COMPLETED"] });
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.