Preview a badge from a group.

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://bump.sh/demo/doc/gitlab/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
"Gitlab (Unofficial) MCP server": {
  "url": "https://bump.sh/demo/doc/gitlab/mcp"
}
Close
GET /groups/{id}/badges/render
Api key auth

This feature was introduced in GitLab 10.6.

Path parameters

  • id string Required

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

Query parameters

  • image_url string Required

    URL of the badge image

Responses

  • 200 application/json

    Preview a badge from a group.

    Hide response attributes Show response attributes object
    • name string
    • link_url string
    • image_url string
    • rendered_link_url string
    • rendered_image_url string
GET /groups/{id}/badges/render 
curl \
 --request GET 'https://www.gitlab.com/api/v4/groups/{id}/badges/render?link_url=string&image_url=string' \
 --header "Private-Token: $API_KEY"
Response examples (200) 
{
  "name": "string",
  "link_url": "string",
  "image_url": "string",
  "rendered_link_url": "string",
  "rendered_image_url": "string"
}