Postman Plugin

@theholocron/holocron-plugin-postman tooling

npm · GitHub

Install

pnpm add -D @theholocron/holocron-plugin-postman

Capabilities

Capability	Token
tooling	HOLOCRON_POSTMAN_API_KEY (postman)

Config

providers: {
  // Single Postman sync
  tooling: ["postman", {
    workspaceId: "abc123-...",
  }],

  // Or alongside other tooling providers (multi)
  tooling: [
    ["postman", { workspaceId: "abc123-..." }],
  ],
}

Options

Option	Required	Description
workspaceId	Yes	Postman workspace id to sync into

Authentication

1. Sign in to web.postman.co
2. Click your avatar (top-right) → Settings → API Keys
3. Click Generate API Key, give it a name, and copy the key — it starts with PMAK-

holocron auth set postman PMAK-xxx

Or via env var:

export HOLOCRON_POSTMAN_API_KEY=PMAK-xxx

What tooling provides

• sync() — pulls the Postman workspace’s authoritative state and reconciles it with the repo’s API definitions (OpenAPI specs, collection files)
• doctor() — returns { ok, message } indicating whether the Postman workspace is reachable and the API key is valid