Run background work

Run background work when a task must continue outside a request path.

Steps

Choose a task for one unit of work.
Use a workflow when work needs multiple ordered steps.
Create the task or workflow target.
Create a schedule when the work needs recurring execution.
Start a durable run when the work needs one-off execution.
Track run status, logs, and events.

Try it with REST

Create a task: POST /projects/{project_reference}/tasks

Terminal

curl -X POST https://api.veryfront.com/projects/support-assistant/tasks \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "daily-summary",
    "name": "Daily summary",
    "schedulable": true
  }'

Create a workflow: POST /projects/{project_reference}/workflows

Terminal

curl -X POST https://api.veryfront.com/projects/support-assistant/workflows \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "support-triage",
    "description": "Classify new support requests and assign next steps.",
    "schedulable": true
  }'

Create a recurring schedule for the task: POST /projects/{project_reference}/schedules

Terminal

curl -X POST https://api.veryfront.com/projects/support-assistant/schedules \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily summary",
    "target": {
      "kind": "task",
      "id": "daily-summary"
    },
    "schedule": "0 8 * * *",
    "timezone": "Etc/UTC",
    "concurrency_policy": "Forbid"
  }'

Start a one-off durable run. Set VERYFRONT_PROJECT_ID to the project’s UUID first. POST /runs

Terminal

curl -X POST https://api.veryfront.com/runs \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"kind\": \"task\",
    \"owner\": {
      \"kind\": \"project\",
      \"id\": \"$VERYFRONT_PROJECT_ID\"
    },
    \"request\": {
      \"name\": \"Daily summary now\",
      \"target\": \"task:daily-summary\"
    }
  }"

API surfaces

Surface	Start here
REST	Tasks, Workflows, Schedules, Runs
GraphQL	Create Task, Create Workflow, Discover Schedules
MCP	Create Task, Create Workflow, Create Schedule

Verify

List tasks and workflows for the project. Confirm the created task and workflow exist. List schedules and confirm the recurring target is active. List runs and confirm one-off work reaches a terminal state.

Choose a target

Target	Use it for
Task	One repeatable background operation.
Workflow	Ordered multi-step automation.
Schedule	Recurring execution of a task or workflow.
Run	Durable execution with status and events.
Webhook	External event ingress.

API reference

API	Start here
REST	Tasks, workflows, schedules, runs, and webhooks.
GraphQL	Task, workflow, schedule, and run views.
MCP	Task, workflow, schedule, and run tools.

Getting Started

Concepts

Conversations API

Guides

Integrations

API Reference

REST API

GraphQL API

MCP API

Run background work

Steps

Try it with REST

API surfaces

Verify

Choose a target

API reference

​Steps

​Try it with REST

​API surfaces

​Verify

​Choose a target

​API reference

Steps

Try it with REST

API surfaces

Verify

Choose a target

API reference