@fetch-hive/sdk package when you want to invoke a workflow deployment from Node.js or TypeScript. The SDK wraps the public POST /v1/workflow/invoke endpoint, handles authentication, and supports both direct responses and callback delivery.
Installation
fetch) and ships with TypeScript types.
Authentication
Set theFETCH_HIVE_API_KEY environment variable to your workspace API key:
Basic example
Run a workflow deployment directly. The call blocks until the workflow finishes:Method reference
Handling the response
Callback delivery
Pass anasync block to return immediately and have Fetch Hive call your callback URL when the run finishes:
webhook_secret so you can verify the signature on the incoming callback. See Callback Delivery and Webhook Triggers for the verification flow and signed payload shape.
Configuration
async: { enabled: true, ... } over increasing client-side timeouts.
Errors
Non-2xx responses throw anError whose message includes the status code and response body:
Links
Next steps
- Callback Delivery and Webhook Triggers - Verify callback signatures
- Run with API - The same flow with cURL
- Run with Python SDK
- Run with Ruby SDK
- Run with PHP SDK
- Invoke Workflow - Full endpoint reference

