> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Run project work

> Run and track jobs, workflows, sandboxes, and hosted services.

Run project work when a task needs durable status, logs, retries, or hosted execution.

## Steps

1. Choose the runtime type for the work.
2. Start a job, workflow, sandbox session, or hosted service.
3. Inspect run status and logs.
4. Retry, cancel, or resume work when the runtime supports it.

## Try it with REST

Create a sandbox session:

`POST /sandbox-sessions`

```bash title="Terminal" theme={null}
curl -X POST https://api.veryfront.com/sandbox-sessions \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ttl_mode": "duration",
    "ttl_hours": 1
  }'
```

Run a job:

`POST /projects/{project_reference}/jobs`

```bash title="Terminal" theme={null}
curl -X POST https://api.veryfront.com/projects/support-assistant/jobs \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Runtime smoke test",
    "target": "tasks/smoke-test",
    "timeout_seconds": 300
  }'
```

## API surfaces

| Surface | Start here                                                                                                                                                     |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| REST    | [Sandbox runtime](/cloud/sandbox), [Tasks](/cloud/rest/api-reference/tasks/create-task), [Runs](/cloud/rest/api-reference/runs/create-a-canonical-durable-run) |
| GraphQL | [Create Job](/cloud/graphql/operations/jobs/mutations/createjob), [Jobs](/cloud/graphql/operations/jobs/queries/jobs)                                          |
| MCP     | [Create Sandbox Session](/cloud/mcp/tools/create-sandbox-session), [Create Job](/cloud/mcp/tools/create-job)                                                   |

## Verify

Check the sandbox session status before running commands.

List jobs and confirm the smoke test reaches a terminal status.

## Choose a runtime path

| Goal                       | Start here                                |
| -------------------------- | ----------------------------------------- |
| Run a background task      | [Run background work](/cloud/automation)  |
| Open an isolated workspace | [Sandbox runtime](/cloud/sandbox)         |
| Understand runtime types   | [Runtimes](/cloud/concepts/runtimes)      |
| Inspect runs and events    | [Runs and events](/cloud/runs-and-events) |

## API reference

| API                       | Use                                                     |
| ------------------------- | ------------------------------------------------------- |
| [REST](/cloud/rest)       | Tasks, workflows, jobs, cron jobs, sandboxes, and runs. |
| [GraphQL](/cloud/graphql) | Runtime, task, workflow, job, and run views.            |
| [MCP](/cloud/mcp)         | Task, workflow, job, sandbox, and run tools.            |
