Use this API to retrieve information about the current state of Sidekiq, including its jobs, queues, and processes, and to delete jobs from a queue.

Delete jobs from a Sidekiq queue

DELETE /api/v4/admin/sidekiq/queues/{queue_name}

Deletes jobs from a Sidekiq queue that match the specified metadata.

Parameters

NameTypeDescription
queue_name
Path, required
StringThe Sidekiq queue name
organization_id
Query
StringMetadata key to match
user
Query
StringMetadata key to match
user_id
Query
StringMetadata key to match
gl_user_id
Query
StringMetadata key to match
scoped_user
Query
StringMetadata key to match
scoped_user_id
Query
StringMetadata key to match
project
Query
StringMetadata key to match
root_namespace
Query
StringMetadata key to match
gl_root_namespace_id
Query
StringMetadata key to match
client_id
Query
StringMetadata key to match
caller_id
Query
StringMetadata key to match
remote_ip
Query
StringMetadata key to match
job_id
Query
StringMetadata key to match
pipeline_id
Query
StringMetadata key to match
related_class
Query
StringMetadata key to match
feature_category
Query
StringMetadata key to match
artifact_size
Query
StringMetadata key to match
artifact_used_cdn
Query
StringMetadata key to match
artifacts_dependencies_size
Query
StringMetadata key to match
artifacts_dependencies_count
Query
StringMetadata key to match
root_caller_id
Query
StringMetadata key to match
merge_action_status
Query
StringMetadata key to match
bulk_import_entity_id
Query
StringMetadata key to match
sidekiq_destination_shard_redis
Query
StringMetadata key to match
kubernetes_agent_id
Query
StringMetadata key to match
mvcc_manifest
Query
StringMetadata key to match
worker_class
Query
StringMetadata key to match

Responses

CodeDescriptionSchema
204No Content—
400Bad Request—
404Not Found—

List all Sidekiq metrics

GET /api/v4/sidekiq/compound_metrics

Lists all Sidekiq metrics. Includes queue, process, and job completion metrics.

Responses

CodeDescriptionSchema
200OK—
401Unauthorized—
403Forbidden—

Retrieve job completion metrics

GET /api/v4/sidekiq/job_stats

Retrieves statistics on the completion status of all Sidekiq jobs.

Responses

CodeDescriptionSchema
200OK—
401Unauthorized—
403Forbidden—

List all Sidekiq processes

GET /api/v4/sidekiq/process_metrics

Lists all details about all registered Sidekiq worker processes, including hostname, process ID, queues, and concurrency settings.

Responses

CodeDescriptionSchema
200OK—
401Unauthorized—
403Forbidden—

List all job queue metrics

GET /api/v4/sidekiq/queue_metrics

Lists all details about all Sidekiq job queues, including backlog size and latency.

Responses

CodeDescriptionSchema
200OK—
401Unauthorized—
403Forbidden—