Flows
A flow is the unit that groups classification traffic and the credentials and integrations attached to it. This guide explains what a flow is, when one is enough, and how to scope tokens and webhooks to a flow.
What a flow is
Section titled “What a flow is”A flow is a named pipeline for classification. Each flow ties together:
- A model: the classification model the flow runs.
- A node: the processing node that runs it.
- The integrations attached to it: API keys, webhooks, and SFTP delivery.
Every organization has a default flow, so you can start submitting video without creating one. When you create additional flows, each becomes an independent lane: an API key belongs to exactly one flow, and a webhook or SFTP integration delivers results for the flow it is attached to.
When to create a flow
Section titled “When to create a flow”One flow is enough for most organizations. Create additional flows when you need to separate traffic that should be configured or delivered differently, for example:
- Separate sites or customers: route each source through its own flow so results can be delivered to different endpoints.
- Separate environments: keep test traffic on its own flow, away from production.
- Different delivery: send one flow’s results to a webhook and another’s to an SFTP destination.
If your traffic shares the same model and the same delivery, keep using the default flow.
Create and manage flows
Section titled “Create and manage flows”-
Open Settings → Platform → Flows.
-
Select Create a flow.
-
Enter a Name, then choose a Model and a Node from the options available to your organization.
-
Save the form. The flow appears in the list, showing its name, model, and node.
To change or remove a flow, open its row menu and select Edit or Delete.
Scope tokens and webhooks to a flow
Section titled “Scope tokens and webhooks to a flow”Integrations are attached to a flow when you create them:
- API keys: when you add an API Key integration in Settings → Platform → Integrations, you select the flow it authenticates against. The key only submits video to that flow. See API Tokens.
- Webhooks and other delivery: when you add a webhook or SFTP integration, you select the flow whose results it should deliver. See Choosing a Delivery Method.
In the integrations list, the Flow column shows which flow each integration is bound to, so you can confirm traffic and delivery line up.