Create long-running polling jobs to wait for external services to complete and trigger callbacks
Polling allows you to create long-running monitoring jobs that wait for external services to complete. This is perfect for tracking job statuses, waiting for processing to finish, handling asynchronous workflows, and integrating with services that require polling for results like video processing, data analysis, or web crawling. The service automatically handles retries, timeouts, and triggers callbacks when operations complete.
Required:
pollUrl
- URL to poll for results (e.g., “https://api.example.com/job/status”)pollUrlToken
- Authentication token for the polling URLcallbackUrl
- URL to call when polling succeeds (e.g., “https://your-app.com/callback”)callbackUrlToken
- Authentication token for the callback URLexpectedResultPattern
- Pattern to match for success with type and patterncallbackPayload
- Data to send to callback URL (supports a results templates)pollTime
- Total time to poll (1m-12h, e.g., “5m”, “2h”)pollFrequency
- How often to poll (5s, 10s, 20s, 30s, 1m, 3m, 5m)Optional:
The command returns:
Polls a job status endpoint every 30 seconds for up to 5 minutes until result.output.text
exists.
Monitors a Firecrawl website crawling job and sends detailed results when complete.
Waits for video processing to complete by checking for “processing complete” string in response.
Pattern Types:
path
- Checks if a JSON path exists (e.g., “result.status”)stringMatch
- Checks if response contains specific textTemplate Variables:
{{results}}
in callback payload to inject polling results{{results.path.to.data}}
to inject specific data from resultsTime Formats:
Error Handling: