Sidekiq queues administration API
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed, GitLab Dedicated
Delete jobs from a Sidekiq queue that match the given metadata.
The response has three fields:
deleted_jobs
- the number of jobs deleted by the request.queue_size
- the remaining size of the queue after processing the request.completed
- whether or not the request was able to process the entire queue in time. If not, retrying with the same parameters may delete further jobs (including those added after the first request was issued).
This API endpoint is only available to administrators.
DELETE /admin/sidekiq/queues/:queue_name
Attribute | Type | Required | Description |
---|---|---|---|
queue_name | string | yes | The name of the queue to delete jobs from |
user | string | no | The username of the user who scheduled the jobs |
project | string | no | The full path of the project where the jobs were scheduled from |
root_namespace | string | no | The root namespace of the project |
subscription_plan | string | no | The subscription plan of the root namespace (GitLab.com only) |
caller_id | string | no | The endpoint or background job that schedule the job (for example: ProjectsController#create , /api/:version/projects/:id , PostReceive ) |
feature_category | string | no | The feature category of the background job (for example: team_planning or code_review ) |
worker_class | string | no | The class of the background job worker (for example: PostReceive or MergeWorker ) |
At least one attribute, other than queue_name
, is required.
Example request:
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/admin/sidekiq/queues/authorized_projects?user=root"
Example response:
{
"completed": true,
"deleted_jobs": 7,
"queue_size": 14
}
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support