PipedreamComing soon
Add live web data to a Pipedream workflow and start workflows when a run finishes. Each value comes back with the page it was read from and when.
SpecStream for PipedreamAutomation
SpecStream isn't in Pipedream's app directory yet. Until it is, a workflow can call the SpecStream API from a code step or an HTTP request with your key as Authorization: Bearer YOUR_SPECSTREAM_API_KEY, and a webhook created in Agents & API can start a workflow from its HTTP trigger URL.
What you need
- A Pipedream account.
- A SpecStream account with an API key to connect it.
- 1
1. Add SpecStream to a workflow
When you add a step or a trigger, search Pipedream's app directory for SpecStream. Its actions and its source are listed under the app.
- 2
2. Create an API key
A key comes from the API keys tab on the Agents & API page. Click Create API key and label it Pipedream.
Compile needs Create and edit requests, and Review Work and Price needs Read saved requests. Approve Quoted Work needs Create and edit requests, Prepare work and follow-ups, and Authorize paid work. Get Status, Get Matching Rows, Register Webhook, and the Find Completed source need Read results and their sources.
A key behind Register Webhook or Find Completed can't be tied to one project. A key that can authorize paid work can carry a Total spending limit. Paid work also depends on a spending limit for your account: Settings, then Usage and billing, then Set a spending limit.
SpecStream displays the key once. Copy it when it appears.
- 3
3. Connect your key
Pipedream asks for API key, and for an optional API base URL that already holds
https://api.specstream.ai. Paste the key and leave the address alone. - 4
4. Read the request with Compile
Compile takes Request and an optional Locale,
en-USby default. It returns how SpecStream read the request, with a request hash, and charges nothing. - 5
5. Review the price
Review Work and Price takes the request hash from Compile, an Operation (
findby default, orextend,add_facts,refresh), and Requested amount. Minimum useful amount, Parent Find for continuation, Project ID, and Saved revision are optional. It prepares the scope and the most it can cost. No work is authorized. - 6
6. Approve the price
Approve Quoted Work takes Reviewed quote ID, Signed quote hash, Stable execution key of 8 to 128 characters, and Exact approved maximum USD. The maximum has to equal the maximum the review showed, in dollars and cents, and nothing fills it in for you. Run the step again with the same key and it reports that it recovered the first run.
- 7
7. Pick up the results
The Find Completed source starts a workflow every time a run completes on your account. Deploying the workflow registers a webhook with SpecStream, and each delivery becomes an event with the run's ID as the event ID.
To send completions to a URL of your choosing, add Register Webhook with a Callback URL. Get Status reads where a run stands from its Find ID, and Get Matching Rows returns the finished records with their sources.
What each component does
| Component | What it does | Cost |
|---|---|---|
| Compile | Reads the request. | Free |
| Review Work and Price | Prepares the scope and the price. | Free |
| Approve Quoted Work | Starts the run within the approved maximum. | Matches only, capped at the approved maximum |
| Get Status | Reads where a run stands. | Free |
| Get Matching Rows | Returns the finished records. | Free |
| Register Webhook | Sends every completed run to a URL. | Free |
| Find Completed | Starts a workflow when a run completes. | Free |
Limits and cost
Runs come from your SpecStream balance, and the approved maximum caps each one. Open balance, quotes, and billing for how rates are set.
Disconnect
Revoke the key in Agents & API to stop every step at once. Webhooks that Register Webhook or Find Completed created are listed under Webhooks there, and revoking one ends its deliveries. Whatever your workflows already sent to other services stays there. For help with a step, write to [email protected].
More
SpecStream for Pipedream covers what it does in Pipedream on one page. Every other tool has its guide in Connect your tools. You see the most a request can cost before it starts, and only the matches come out of your balance. Billing has the details. For help, email [email protected].