# Update badge

`PUT /admin/badges/{id}.json`

Authentication: no security requirement declared for this operation.

Parameters:

- `id` (path, integer, required)
  Type: integer

Request body: application/json

Type: any

- `name` (required)
  Type: string
  
  The name for the new badge.

- `badge_type_id` (required)
  Type: integer
  
  The ID for the badge type. 1 for Gold, 2 for Silver,
  3 for Bronze.

Additional properties: false

Responses:

- 200: success response

Content type: application/json

Type: any

- `badge_types` (required)
  Type: Array<object>
  
  Items:
    Type: object
    
    - `id` (required)
      Type: integer
    
    - `name` (required)
      Type: string
    
    - `sort_order` (required)
      Type: integer
    
    Additional properties: false

- `badge` (required)
  Type: object
  
  - `id` (required)
    Type: integer
  
  - `name` (required)
    Type: string
  
  - `description` (required)
    Type: string
  
  - `grant_count` (required)
    Type: integer
  
  - `allow_title` (required)
    Type: boolean
  
  - `multiple_grant` (required)
    Type: boolean
  
  - `icon` (required)
    Type: string
  
  - `image_url` (required)
    Type: string; nullable
  
  - `image_upload_id` (required)
    Type: integer; nullable
  
  - `listable` (required)
    Type: boolean
  
  - `enabled` (required)
    Type: boolean
  
  - `badge_grouping_id` (required)
    Type: integer
  
  - `system` (required)
    Type: boolean
  
  - `long_description` (required)
    Type: string
  
  - `slug` (required)
    Type: string
  
  - `manually_grantable` (required)
    Type: boolean
  
  - `query` (required)
    Type: string; nullable
  
  - `trigger` (required)
    Type: string; nullable
  
  - `target_posts` (required)
    Type: boolean
  
  - `auto_revoke` (required)
    Type: boolean
  
  - `show_posts` (required)
    Type: boolean
  
  - `badge_type_id` (required)
    Type: integer
  
  - `show_in_post_header` (required)
    Type: boolean
  
  Additional properties: false

Additional properties: false

## Examples

### cURL

```bash
curl -X PUT 'https://discourse.example.com/admin/badges/0.json' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "name": "string",
  "badge_type_id": 0
}'
```

### JavaScript

```javascript
const body = `{
  "name": "string",
  "badge_type_id": 0
}`;

const response = await fetch('https://discourse.example.com/admin/badges/0.json', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();
```

### Python

```python
import requests

body = '''{
  "name": "string",
  "badge_type_id": 0
}'''

response = requests.put(
    'https://discourse.example.com/admin/badges/0.json',
    data=body.encode('utf-8'),
    headers={
        'Content-Type': 'application/json',
    },
)
print(response.text)
```