debian-mirror-gitlab/doc/api/group_wikis.md
2020-08-09 17:44:08 +05:30

7.5 KiB

Wikis API

Introduced in GitLab 13.2.

Available only in APIv4.

List wiki pages

List all wiki pages for a given group.

GET /groups/:id/wikis
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the group
with_content boolean no Include pages' content
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/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 group.

GET /groups/:id/wikis/:slug
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the group
slug string yes The slug (a unique string) of the wiki page
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/1/wikis/home"

Example response:

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

Create a new wiki page

Create 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 group
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, asciidoc and org
curl --data "format=rdoc&title=Hello&content=Hello world" \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/groups/1/wikis"

Example response:

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

Edit an existing wiki page

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

PUT /groups/:id/wikis/:slug
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the group
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, asciidoc and org
slug string yes The slug (a unique identifier) of the wiki page
curl --request PUT --data "format=rdoc&content=documentation&title=Docs" \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/groups/1/wikis/foo"

Example response:

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

Delete a wiki page

Delete a wiki page with a given slug.

DELETE /groups/:id/wikis/:slug
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the group
slug string yes The slug (a unique identifier) of the wiki page
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/1/wikis/foo"

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

Upload an attachment to the wiki repository

Upload a file to the attachment folder inside the wiki's repository. The attachment folder is the uploads folder.

POST /groups/:id/wikis/attachments
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the group
file string yes The attachment to be uploaded
branch string no The name of the branch. Defaults to the wiki repository default branch

To upload a file from your filesystem, use the --form argument. This causes cURL to post data using the header Content-Type: multipart/form-data. The file= parameter must point to a file on your filesystem and be preceded by @. For example:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --form "file=@dk.png" "https://gitlab.example.com/api/v4/groups/1/wikis/attachments"

Example response:

{
  "file_name" : "dk.png",
  "file_path" : "uploads/6a061c4cf9f1c28cb22c384b4b8d4e3c/dk.png",
  "branch" : "master",
  "link" : {
    "url" : "uploads/6a061c4cf9f1c28cb22c384b4b8d4e3c/dk.png",
    "markdown" : "![dk](uploads/6a061c4cf9f1c28cb22c384b4b8d4e3c/dk.png)"
  }
}