bem operates asynchronously. Whether you call a Workflow or a Function, you receive the results via Webhooks or by polling.

Subscribing via Webhooks (Recommended)

You can create a Subscription to listen for events. When a step in your workflow completes, bem sends a POST request to your configured URL.

Events include:

• transform: A transformation completed successfully.
• join: A join operation completed.
• route: A routing decision was made.

Example: Creating a Subscription

1curl -X POST https://api.bem.ai/v1-alpha/subscriptions \
2  -H "x-api-key: <YOUR_BEM_API_KEY>" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "name": "Production Webhook",
6    "webhookURL": "https://api.your-company.com/webhooks/bem"
7  }'

Polling

Alternatively, you can poll for results using the /v2/calls/{callID} endpoint to check the status of a specific call, or list events via /v1-alpha/events.