---
title: "Bulk Update App Configuration"
method: PUT
path: "/partner/account/apps/config"
tags: ["Partner"]
---

# Bulk Update App Configuration

`PUT /partner/account/apps/config`

## Request

- Base URL: `https://partner.gupshup.io`
- URL: `https://partner.gupshup.io/partner/account/apps/config`
- Auth: none declared. Required headers: `Authorization`

Use this API when you need to roll out the **same setting across all WhatsApp apps** under your partner account — for example, enabling a feature flag for every linked app.

**How it works**
1. Submit the configuration you want applied, along with your Partner ID.
2. You receive instant confirmation and the total number of apps queued.
3. Updates run in the background — you do not need to wait on the API call.
4. The partner admin receives an email when processing completes.

**Important:** There is no job tracking ID. The completion email is how you know the update has finished.

**Email outcomes**
- All apps succeed → success email with summary counts; no attachment.
- Some apps fail → email with summary plus a CSV listing failed app IDs and error reasons.

**Access:** Partner Admin or Partner User. Partner ID must match your logged-in account. Rate limit: 1 requests per 60 seconds.

## Query parameters

- `partnerId` integer, required

## Headers

- `Authorization` string, required

## Request body

- AppConfigUpdateRequest: Configuration settings to apply to each linked app (for example, enabling or disabling a feature). The exact fields depend on the setting you are updating.

## Response `202`

Your bulk update has been queued successfully. You can continue other work — the partner admin will receive an email with the final results when all apps have been processed.

- PartnerAppConfigUpdateAcceptedResponse
  - `status` string, required: Indicates the bulk update was successfully queued
  - `message` string, required: Confirmation message — processing continues in the background and the partner admin will be emailed when complete
  - `partnerId` string, required: The partner account this bulk update applies to
  - `totalApps` string, required: How many apps were queued for update — check the partner admin email for final success/failure counts

## Other responses

- `400`: The request could not be accepted — Partner ID is missing, the partner account was not found, or no configuration was provided in the request body.
- `401`: You are not signed in or your partner token is invalid. Please log in and try again.
- `403`: You do not have permission to run this update — either the Partner ID does not match your account, or your user role is not allowed.
- `404`: No WhatsApp apps are linked to this partner account. Link apps before running a bulk config update.
- `429`: Too many bulk update requests in a short time. Please wait and try again (limit: 10 requests per 60 seconds).
- `500`: Something went wrong on our side. Please try again later or contact Gupshup support if the issue continues.

---

[API](https://skmtc.dev/gupshup/apis/bulk-update-app-configuration-for-all-partner-apps.md) - [All operations](https://skmtc.dev/gupshup/apis/bulk-update-app-configuration-for-all-partner-apps/llms.txt) - [OpenAPI document](https://skmtc.dev/gupshup/apis/bulk-update-app-configuration-for-all-partner-apps/revisions/027b7ac2fd67?raw)