SC26AI agents lab + dinner on the river · Nov 17
Parallel Works
View as Markdown
Share:

SDKs

Parallel Works publishes official client libraries for the ACTIVATE REST API in three languages:

  • TypeScript — @parallelworks/client on npm, with optional SWR hooks for React
  • Python — parallelworks-client on PyPI, with sync and async support
  • Go — github.com/parallelworks/sdk/go

All three SDKs are generated from the same OpenAPI specification that powers the API reference, so every endpoint is available with full type definitions.

Authentication

Signed in with pw auth

For scripts you run yourself, sign in with pw auth once, then create the client from the CLI's credentials file. The client uses your sign-in and renews it automatically by running pw auth token --print -o json, so the CLI must be installed and on your PATH.

SDKCreate the client
Goparallelworks.NewClientFromCredentialConfig()
PythonClient.from_credential_config()
TypeScriptClient.fromCredentialConfig() (Node.js 20.16 or later)

The client uses the same context as the CLI: PW_API_KEY if set, then the context you name, PW_CONTEXT, and the current context.

API keys

For CI and other automation that runs without you, use an API key (pwt_...). Create it in your account settings; every key expires, by default within 730 days. An API key contains your platform host, so each SDK can create a client from the key alone, with no URL required. Each SDK also accepts an explicit platform host.

Note

Treat API keys and tokens with the same care as your login password. Store them in environment variables or a secrets manager rather than committing them to source control.

Next Steps

  • TypeScript — Install and use @parallelworks/client
  • Python — Install and use parallelworks-client
  • Go — Install and use the Go client
  • API Reference — Browse every endpoint, with schemas and examples