# Jobs

Endpoints for monitoring and managing background job queues, including statistics, job listings, and queue monitoring

## List all job types

 - [GET /api/v1/jobs/list-jobs](https://docs.wellesley.social/openapi/jobs/paths/~1api~1v1~1jobs~1list-jobs/get.md): Returns a list of all available job types in the system. Supports pagination.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage

## Get statistics for a specific queue

 - [GET /api/v1/jobs/list-stats](https://docs.wellesley.social/openapi/jobs/paths/~1api~1v1~1jobs~1list-stats/get.md): Returns detailed statistics for a specific job queue including counts of finished, failed, active, submitted, and retry jobs.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage

## Get statistics for all queues

 - [GET /api/v1/jobs/list-stats-all](https://docs.wellesley.social/openapi/jobs/paths/~1api~1v1~1jobs~1list-stats-all/get.md): Returns aggregated statistics across all job queues including counts of finished, failed, active, submitted, scheduled, and retry jobs.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage

## List jobs by status in a queue

 - [GET /api/v1/jobs/lists](https://docs.wellesley.social/openapi/jobs/paths/~1api~1v1~1jobs~1lists/get.md): Returns a paginated list of jobs with a specific status (finished, failed, active, submitted, retries, schedule) from a specific queue.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage

## Get overall job statistics

 - [GET /api/v1/jobs/stats](https://docs.wellesley.social/openapi/jobs/paths/~1api~1v1~1jobs~1stats/get.md): Returns aggregated statistics for all finished and failed jobs across all queues. Requires Jobs.Read or Jobs.Manage permission.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage

## Get daily job statistics

 - [GET /api/v1/jobs/stats-per-day](https://docs.wellesley.social/openapi/jobs/paths/~1api~1v1~1jobs~1stats-per-day/get.md): Returns job statistics broken down by day for the specified number of past days. Can be filtered by queue or aggregated across all queues.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage