@fetch-hive/sdk package when you want to start a Hive Agent run from Node.js or TypeScript. The SDK wraps the public POST /v1/hive-agent/invoke endpoint with a typed client and handles authentication.
Hive Agent invocation does not stream and does not wait for the final answer in the HTTP response. The SDK returns identifiers immediately, then Fetch Hive sends a signed callback when the run completes, fails, or is cancelled.
Installation
fetch) and ships with TypeScript types out of the box.
Authentication
Set theFETCH_HIVE_API_KEY environment variable to your workspace API key:
Basic example
Start a Hive Agent run and read the accepted response:invokeHiveAgent returns a Promise that resolves to the parsed JSON body as soon as the run is queued. See the accepted response shape.
Method reference
The SDK always sends
async.enabled: true with your callback_url. Hive Agent invocation is async-only.
Handling the response
Fetch Hive returns202 Accepted when the run is queued. Store webhook_secret so your callback receiver can verify X-Fetch-Hive-Signature.
Configuration
Errors
Missingcallback_url throws before a request is sent. Non-2xx responses throw an Error whose message includes the status code and response body:
Links
Next steps
- Invoke from Code - Overview of starting runs from your app
- Run with Python SDK
- Run with Ruby SDK
- Run with PHP SDK
- Invoke - Full endpoint reference

