# Admin Jobs

Administrative endpoints for monitoring and managing background job queues. Provides statistics, job listings, and queue monitoring for all asynchronous tasks such as federation delivery, media processing, and cleanup jobs. Requires Jobs.Read or Jobs.Manage permission.

## Clear all jobs for a status

 - [DELETE /api/v1/jobs/clear](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1clear/delete.md): Removes all jobs from the specified list. Cannot clear active jobs (would orphan coroutines). Requires Jobs.Manage permission.

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

## List dead letter queue jobs

 - [GET /api/v1/jobs/dlq](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1dlq/get.md): Returns a paginated list of jobs in the dead letter queue (DLQ). These are jobs that failed deserialization and were moved out of normal processing.

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

## Delete a specific job

 - [DELETE /api/v1/jobs/job](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1job/delete.md): Deletes a job from the specified list (submitted, finished, failed, retries, schedule, dlq). Cannot delete active jobs. Requires Jobs.Manage permission.

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

## List all job types

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

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

## List active job processor instances

 - [GET /api/v1/jobs/processes](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1processes/get.md): Returns all active job processor instances with their hostname, PID, and last heartbeat time.

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

## Get Redis server info

 - [GET /api/v1/jobs/redis-info](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1redis-info/get.md): Returns basic Redis server information including version, memory usage, and connected clients.

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

## Retry a single failed job

 - [POST /api/v1/jobs/retry](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1retry/post.md): Moves a failed job back to the submitted queue with tries reset to 0. Requires Jobs.Manage permission.

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

## Retry all failed jobs in a queue

 - [POST /api/v1/jobs/retry-all](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1retry-all/post.md): Moves all failed jobs in the specified queue back to submitted with tries reset. Requires Jobs.Manage permission.

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

## Get overall job statistics

 - [GET /api/v1/jobs/stats](https://docs.wellesley.social/openapi/admin-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/admin-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

## Get combined per-queue summary

 - [GET /api/v1/jobs/summary](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1summary/get.md): Returns a combined summary for all queues including job counts, latency, and worker configuration. Single call replaces multiple stats calls.

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

## Get worker configuration

 - [GET /api/v1/jobs/workers](https://docs.wellesley.social/openapi/admin-jobs/paths/~1api~1v1~1jobs~1workers/get.md): Returns static configuration for all registered workers including queue name, description, max retries, concurrency, and enabled status.

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