fetch-hive/sdk Composer package when you want to invoke a workflow deployment from PHP. The SDK wraps the public POST /v1/workflow/invoke endpoint, handles authentication, and supports both direct responses and callback delivery.
Installation
Authentication
Set theFETCH_HIVE_API_KEY environment variable to your workspace API key (the client reads it automatically):
Basic example
Run a workflow deployment directly. The call blocks until the workflow finishes:Method reference
invokeWorkflow builds the request body for you. When you pass async_mode: true, the SDK sends:
Handling the response
Callback delivery
Passasync_mode: true 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
Errors
Non-2xx responses throwFetchHive\Sdk\Exception\ApiException carrying 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 Node.js SDK
- Run with Ruby SDK
- Invoke Workflow - Full endpoint reference

