Skip to content
forgit api docs

Create a project topic

POST
/api/v4/topics

Creates a project topic. Administrators only.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typemultipart/form-data
object
name
required

Slug (name)

string
nullable
title
required

Title

string
nullable
description

Description

string
nullable
avatar

Avatar image for topic

string format: binary
nullable
organization_id

The organization id for the topic

integer
nullable

Responses

Section titled “Responses”

201

Section titled “201”

Created

Media typeapplication/json
object
id
integer format: int64
name
string
title
string
description
string
total_projects_count
integer
organization_id
integer format: int64
avatar_url
string
Example
{
  "id": 1,
  "name": "topic1",
  "title": "Topic 1",
  "description": "A description",
  "total_projects_count": 1,
  "organization_id": 1,
  "avatar_url": "http://gitlab.example.com/uploads/topic/avatar/1/avatar.png"
}

400

Section titled “400”

Bad Request