---
title: "Update badges"
method: PUT
path: "/api_gateway/v1/badges/badgeMeta"
---

# Update badges

`PUT /api_gateway/v1/badges/badgeMeta`

## Request body

- object
  - `RAW_BODY` string, json — { "id": "65608f5dfd9efd4da77df8a0", "orgId": 100606, "name": "2023GIVE", "description": "Badge awarded to members who donated to the NASCAR Foundation during the 2023 Giveathon", "startOn": 1700827200.000000000, "expiresOn": 1703178000.000000000, "issuedBadgeExpiry": { "expiryType": "NEVER" }, "earnedBadgeExpiry": { "expiryType": "RELATIVE", "relativeExpirytype": "WEEKS", "value": 2 }, "images": [ { "name": "InProgress", "fileSvcHandle": "qwer-8634-8938", "url": "https://firebasestorage.googleapis.com/v0/b/createbadges.appspot.com/o/images%2Fimages.png?alt=media&token=4d4c91d5-ac16-41e3-a35c-d8502814b966", "tag": "IN_PROGRESS" }, { "name": "Issued", "fileSvcHandle": "qwer-8634-8938", "url": "https://firebasestorage.googleapis.com/v0/b/createbadges.appspot.com/o/images%2Fsuccess1.jpg?alt=media&token=66b2f0bc-9c55-4e33-a5e9-c6be96d94f2d", "tag": "EARNED" }, { "name": "Unissued", "fileSvcHandle": "qwer-8634-8938", "url": "https://firebasestorage.googleapis.com/v0/b/createbadges.appspot.com/o/images%2F345.jpg?alt=media&token=2d2ec9b0-e3e2-419e-9710-2cd7036b22c1", "tag": "UN_EARNED" } ], "ownership": { "restrictedToOwners": [ "Audience_Campaigns" ], "claims": [] }, "customerConstraints": [], "badgeConstraints": [], "benefits": [ { "benefitType": "COUPON", "seriesId": 13893 } ], "tags": [], "badgeGroupId": 10, "badgeRank": 3, "earnType": "ISSUE_EARN", "issuedCount": 1, "earnedCount":1, "status": "LIVE", "createdOn": 1700826973.505000000, "createdBy": 75097228, "lastUpdatedOn": 1700826973.505000000, "lastUpdatedBy": 75097228, "customFields": { "CF1": "CF1", "CF2 INTEGER": "1", "CF3 boolean": "true", "CF3 date": "2001-01-18 09:09:09", "CF31 date": "" }, "active": true }

## Response `200`

200

- object
  - `data` object
    - `id` string
    - `badgeNumericId` integer
    - `orgId` integer
    - `name` string
    - `description` string
    - `startOn` integer
    - `expiresOn` integer
    - `earnedBadgeExpiry` object
      - `expiryType` string
      - `type` string
      - `expiresOn` integer
      - `expireWithBadgeMeta` boolean
    - `issuedBadgeExpiry` object
      - `expiryType` string
      - `type` string
      - `expiresOn` integer
      - `expireWithBadgeMeta` boolean
    - `images` unknown[]
      - unknown
    - `ownership` object
      - `restrictedToOwners` string[]
      - `claims` unknown[]
        - unknown
    - `customerConstraints` unknown[]
      - unknown
    - `badgeConstraints` unknown[]
      - unknown
    - `benefits` unknown[]
      - unknown
    - `badgeGroupId` unknown
    - `badgeRank` unknown
    - `earnType` string
    - `status` string
    - `createdOn` number
    - `createdBy` integer
    - `lastUpdatedOn` number
    - `lastUpdatedBy` integer
    - `customFields` object
    - `active` boolean
  - `errors` unknown[]
    - unknown
  - `warnings` unknown[]
    - unknown

## Other responses

- `400` — 400

---

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