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 job to run the target.
Add a cron job when the work needs a schedule.
Track job 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
  }'

Run the task with a one-off job: POST /projects/{project_reference}/jobs

Terminal

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

Schedule the same target: POST /projects/{project_reference}/cron-jobs

Terminal

curl -X POST https://api.veryfront.com/projects/support-assistant/cron-jobs \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily summary schedule",
    "target": "tasks/daily-summary",
    "schedule": "0 9 * * *",
    "timezone": "UTC"
  }'

API surfaces

Surface	Start here
REST	Tasks, Workflows, Schedules, Runs
GraphQL	Create Job, Create Cron Job
MCP	Create Task, Create Workflow, Create Job, Create Cron Job

Verify

List tasks and workflows for the project. Confirm the created task and workflow exist. List jobs and confirm the one-off job appears. List cron jobs and confirm the schedule is active.

Choose a target

Target	Use it for
Task	One repeatable background operation.
Workflow	Ordered multi-step automation.
Job	Durable execution of a task or workflow.
Cron job	Scheduled job creation.
Webhook	External event ingress.

API reference

API	Start here
REST	Tasks, workflows, jobs, cron jobs, and webhooks.
GraphQL	Task, workflow, and job views.
MCP	Job and automation 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