---
title: "Update a badge config"
method: PATCH
path: "/orgs/{orgId}/badgeConfigs/{badgeConfigId}"
tags: ["orgs/badgeConfigs"]
---

# Update a badge config

`PATCH /orgs/{orgId}/badgeConfigs/{badgeConfigId}`

__JWT is required for this endpoint with at least one of the following scopes__: o{params.orgId}-configurations:w,o{params.orgId}-badgePrinting:w,o{params.orgId}-mobileAppSettings:w,o:w,s-o:w<br/><br/>__Endpoint name__: updateBadgeConfig

## Path parameters

- `orgId` integer, required
- `badgeConfigId` integer, required

## Request body

- object
  - `nameConfig` object
    - `isEnabled` boolean, nullable
    - `color` string, nullable
    - `fontFamily` string, nullable
    - `fontSize` number, nullable
    - `lineHeight` number, nullable
    - `fontWeight` number, nullable
    - `fontStyle` 'italic' | 'oblique' | 'none', nullable
    - `textAlign` 'left' | 'center' | 'right', nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
    - `layout` 'threeLines' | 'twoLines' | 'oneLine', nullable
    - `textTransform` 'none' | 'uppercase' | 'lowercase' | 'capitalize', nullable
  - `customField1Config` object
    - `isEnabled` boolean, nullable
    - `color` string, nullable
    - `fontFamily` string, nullable
    - `fontSize` number, nullable
    - `lineHeight` number, nullable
    - `fontWeight` number, nullable
    - `textAlign` 'left' | 'center' | 'right', nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
  - `customField2Config` object
    - `isEnabled` boolean, nullable
    - `color` string, nullable
    - `fontFamily` string, nullable
    - `fontSize` number, nullable
    - `lineHeight` number, nullable
    - `fontWeight` number, nullable
    - `textAlign` 'left' | 'center' | 'right', nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
  - `backgroundConfig` object
    - `isEnabled` boolean, nullable
    - `backgroundColor` string, nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
  - `photoConfig` object
    - `isEnabled` boolean, nullable
    - `backgroundColor` string, nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
    - `borderRadius` number, nullable
    - `borderColor` string, nullable
  - `logoConfig` object
    - `isEnabled` boolean, nullable
    - `backgroundColor` string, nullable
    - `backgroundPosition` string, nullable
    - `label` string, nullable
    - `color` string, nullable
    - `fontFamily` string, nullable
    - `fontSize` number, nullable
    - `lineHeight` number, nullable
    - `fontWeight` number, nullable
    - `textAlign` 'left' | 'center' | 'right', nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
  - `externalIdConfig` object
    - `isEnabled` boolean, nullable
    - `color` string, nullable
    - `fontFamily` string, nullable
    - `fontSize` number, nullable
    - `lineHeight` number, nullable
    - `fontWeight` number, nullable
    - `textAlign` 'left' | 'center' | 'right', nullable
    - `centerX` number, nullable
    - `centerY` number, nullable
    - `width` number, nullable
    - `height` number, nullable
  - `customField1Id` integer, nullable
  - `customField2Id` integer, nullable
  - `backgroundPicture` object, nullable
    - `base64` string, required
  - `logoPicture` object, nullable
    - `base64` string, required
  - `name` string, nullable
  - `badgeDefaultConfigId` integer
  - `badgeBorderRadius` integer
  - `isOrgDefault` boolean

## Response `204`

No Content

---

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