# Adds a badge to a project.

**POST /projects/{id}/badges**

This feature was introduced in GitLab 10.6.


## Servers
- https://www.gitlab.com/api/v4: https://www.gitlab.com/api/v4 ()


## Authentication methods
- Api key auth


## Parameters

### Path parameters
- **id** (string | integer)
  The ID or [URL-encoded path of the project](https://docs.gitlab.com/api/rest/#namespaced-paths).


### Body: application/json (object)

- **link_url** (string)
  URL of the badge link
- **image_url** (string)
  URL of the badge image
- **name** (string)
  Name for the badge


## Responses
### 201
Adds a badge to a project.

#### Body: application/json (object)
- **name** (string)

- **link_url** (string)

- **image_url** (string)

- **rendered_link_url** (string)

- **rendered_image_url** (string)

- **id** (string)

- **kind** (string)



[Powered by Bump.sh](https://bump.sh)