gitlab-org--gitlab-foss/doc/api/wikis.md

Wikis API

[Introduced][ce-13372] in GitLab 10.0.

Available only in APIv4.

List wiki pages

Get all wiki pages for a given project.

GET /projects/:id/wikis

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
with_content	boolean	no	Include pages' content

curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/projects/1/wikis?with_content=1

Example response:

[
  {
    "content" : "Here is an instruction how to deploy this project.",
    "format" : "markdown",
    "slug" : "deploy",
    "title" : "deploy"
  },
  {
    "content" : "Our development process is described here.",
    "format" : "markdown",
    "slug" : "development",
    "title" : "development"
  },{
    "content" : "*  [Deploy](deploy)\n*  [Development](development)",
    "format" : "markdown",
    "slug" : "home",
    "title" : "home"
  }
]

Get a wiki page

Get a wiki page for a given project.

GET /projects/:id/wikis/:slug

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
slug	string	yes	The slug (a unique string) of the wiki page

curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/projects/1/wikis/home

Example response:

[
  {
    "content" : "home page",
    "format" : "markdown",
    "slug" : "home",
    "title" : "home"
  }
]

Create a new wiki page

Creates a new wiki page for the given repository with the given title, slug, and content.

POST /projects/:id/wikis

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
content	string	yes	The content of the wiki page
title	string	yes	The title of the wiki page
format	string	no	The format of the wiki page. Available formats are: markdown (default), rdoc, and asciidoc

curl --data "format=rdoc&title=Hello&content=Hello world" --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v4/projects/1/wikis"

Example response:

{ 
  "content" : "Hello world",
  "format" : "markdown",
  "slug" : "Hello",
  "title" : "Hello"
} 

Edit an existing wiki page

Updates an existing wiki page. At least one parameter is required to update the wiki page.

PUT /projects/:id/wikis/:slug

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
content	string	yes if title is not provided	The content of the wiki page
title	string	yes if content is not provided	The title of the wiki page
format	string	no	The format of the wiki page. Available formats are: markdown (default), rdoc, and asciidoc
slug	string	yes	The slug (a unique string) of the wiki page

curl --request PUT --data "format=rdoc&content=documentation&title=Docs" --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v4/projects/1/wikis/foo"

Example response:

{
  "content" : "documentation",
  "format" : "markdown",
  "slug" : "Docs",
  "title" : "Docs"
}

Delete a wiki page

Deletes a wiki page with a given slug.

DELETE /projects/:id/wikis/:slug

Attribute	Type	Required	Description
id	integer/string	yes	The ID or URL-encoded path of the project
slug	string	yes	The slug (a unique string) of the wiki page

curl --request DELETE --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" "https://gitlab.example.com/api/v4/projects/1/wikis/foo"

On success the HTTP status code is 204 and no JSON response is expected.