Skip to main content
These workflows map directly to Task Service API operations but are presented from a user experience perspective.

​
Create a task from the dashboard

The user:
  1. Opens the task creation view
  2. Provides a name, target URLs, and objective
  3. Defines the output schema
  4. Selects whether the task runs once or on a schedule
  5. Saves the task
This maps to POST /api/v1/tasks in the Task Service API.

​
Run a task

The user:
  1. Opens an existing task
  2. Clicks run
  3. Monitors the execution in the execution list or detail view
This maps to POST /api/v1/tasks/:id/run.

​
Monitor execution progress

The user:
  1. Opens the execution detail view
  2. Watches status transitions (queued → running → completed)
  3. Reviews progress indicators and phase labels
  4. Inspects logs or error messages if something fails
This maps to GET /api/v1/executions/:id.

​
Export results

The user:
  1. Opens a completed execution
  2. Downloads results as CSV or JSON
  3. Inspects dataset details if available
This maps to result and dataset endpoints under /api/v1/executions/:id/results.

​
Browse and use templates

The user:
  1. Opens the template catalog
  2. Filters by category or searches by keyword
  3. Selects a template and reviews its configuration
  4. Runs a preview to validate the template against their target
  5. Creates a task from the template when satisfied
This maps to template and preview endpoints under /api/v1/templates.

​
Review analytics

The user:
  1. Opens the analytics dashboard
  2. Reviews usage summaries, execution trends, and task-level statistics
  3. Drills into specific execution or task metrics
This maps to analytics endpoints under /api/v1/analytics.

​
Check billing and usage

The user:
  1. Opens the billing view
  2. Reviews wallet balance and credit usage
  3. Inspects the ledger for detailed transaction history
  4. Reviews monthly statements
This maps to billing endpoints under /api/v1/billing.

​
Use templates to speed up setup

The user:
  1. Browses the template catalog
  2. Selects a starting point
  3. Validates the workflow through preview or initial runs
  4. Promotes it into a task they own
This makes task creation faster and more consistent across teams.

​
Next steps