---
title: "Fetch the configuration of a Background Job Handler"
method: POST
path: "/v1/background_job_handler/configuration"
tags: ["Background Jobs"]
---

# Fetch the configuration of a Background Job Handler

`POST /v1/background_job_handler/configuration`

Request the configuration for a Background Job Handler

## Request body

- BackgroundJobHandlerConfigurationRequest
  - `executor` 'AI' | 'AI_AGENT' | 'AI_BG' | 'BROKER' | 'COMPLIANCE' | 'COST' | 'COST_BG' | 'COST_BG_CLOUD_BILLING' | 'COST_BG_K8S_BILLING' | 'FEATURE_FLAGS' | 'GOVERNANCE' | 'HEATSTACK' | 'HEATSTACK_BG' | 'IDENTITY' | 'IDENTITY_BG' | 'OPERATIONS' | 'REPORT_GENERATION' | 'RESOURCE_INVENTORY' | 'RESOURCE_INVENTORY_BG' | 'SECURITY' — Target executor
  - `payload_type` string — Target payload type

## Response `200`

Fetched

- BackgroundJobHandlerConfiguration
  - `max_parallel_jobs` integer — Maximum number of concurrent jobs to process
  - `max_processes` integer — Maximum number of workers to run jobs
  - `default_max_parallel_jobs` integer — Default value for number of concurrent jobs to process
  - `default_max_processes` integer — Default value for number of workers to run jobs
  - `override_expiration` string, date-time — Override defaults until expiration

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.net/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)