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

# jobs • AI Agents Framework

> Async Jobs API for PraisonAI.

# jobs

<Badge color="purple">AI Agents Framework</Badge>

Async Jobs API for PraisonAI.

Provides HTTP API endpoints for long-running agent tasks:

* Submit jobs (POST /api/v1/runs)
* Check status (GET /api/v1/runs/\{job\_id})
* Get results (GET /api/v1/runs/\{job\_id}/result)
* Cancel jobs (POST /api/v1/runs/\{job\_id}/cancel)
* Stream progress (GET /api/v1/runs/\{job\_id}/stream)

Zero Performance Impact:

* All imports are lazy loaded via **getattr**
* Server only starts when explicitly requested
* No overhead when not in use

Usage:

# Start the jobs server

praisonai serve --port 8005

# Or programmatically

from praisonai.jobs import start\_server
start\_server(port=8005)

## Import

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai import jobs
```

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Async Jobs" icon="list-check" href="/docs/features/async-jobs" />

  <Card title="Background Tasks" icon="clock" href="/docs/features/background-tasks" />
</CardGroup>