List all topics

GET

/api/v4/topics

• GitLab REST API

Lists all project topics sorted by the number of associated projects.

Authorizations

• http
• oauth2

Parameters

Query Parameters

search

string

nullable

Return list of topics matching the search criteria

Example

search

without_projects

boolean

nullable

Return list of topics without assigned projects

organization_id

integer

nullable

The organization id for the topics

page

integer

default: 1 nullable

Current page number

Example

1

per_page

integer

default: 20 nullable

Number of items per page

Example

20

Responses

200

OK

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

Bad Request