Update a badge for a project

PUT

/api/v4/projects/{id}/badges/{badge_id}

• GitLab REST API

Updates a specified badge for a project.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

string

The ID or URL-encoded path of the project owned by the authenticated user.

badge_id

required

integer

The badge ID

Request Body

Media typeapplication/json

object

link_url

URL of the badge link

string

nullable

image_url

URL of the badge image

string

nullable

name

Name for the badge

string

nullable

Example^generated

{
  "link_url": "example",
  "image_url": "example",
  "name": "example"
}

Responses

200

OK

Media typeapplication/json

object

name

string

link_url

string

image_url

string

rendered_link_url

string

rendered_image_url

string

id

integer format: int64

kind

string

Example

{
  "name": "Pipeline Status",
  "link_url": "https://example.gitlab.com",
  "image_url": "https://example.gitlab.com",
  "rendered_link_url": "https://example.gitlab.com",
  "rendered_image_url": "https://example.gitlab.com",
  "id": 1,
  "kind": "project"
}

400

Bad Request

404

Not Found