Create a wiki page for a project

POST

/api/v4/projects/{id}/wikis

• GitLab REST API

Creates a wiki page for a specified project. Requests can define the title, slug, and content.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the group or project

Request Body ^required

Media type application/json

object

title

required

Title of a wiki page

string

nullable

front_matter

Object that contains YAML frontmatter

object

title

Frontmatter title of a wiki page

string

nullable

content

required

Content of a wiki page

string

nullable

format

Format of a wiki page. Available formats are markdown, rdoc, asciidoc and org

string

default: markdown nullable

Allowed values: markdown rdoc asciidoc org

Responses

201

Created

Media type application/json

object

format

string

slug

string

title

string

wiki_page_meta_id

integer format: int64

content

string

encoding

string

front_matter

object

Example

{
  "format": "markdown",
  "slug": "deploy",
  "title": "deploy",
  "wiki_page_meta_id": 123,
  "content": "Here is an instruction how to deploy this project.",
  "encoding": "UTF-8",
  "front_matter": {
    "title": "deploy"
  }
}

400

Validation error

404

Not found

422

Unprocessable entity