Create a wiki page

POST

/repos/{owner}/{repo}/wiki/new

curl --request POST \
  --url https://gitea.com/api/v1/repos/example/example/wiki/new \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "content_base64": "example", "message": "example", "title": "example" }'

Authorizations

• BasicAuth
• Token
• AccessToken
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Parameters

Path Parameters

owner

required

string

Owner of the repo

repo

required

string

Name of the repo

Request Body

Media typeapplication/json

CreateWikiPageOptions form for creating wiki

object

content_base64

Content must be base64 encoded

string

message

Optional commit message summarizing the change

string

title

Page title. leave empty to keep unchanged

string

Example^generated

{
  "content_base64": "example",
  "message": "example",
  "title": "example"
}

Responses

201

WikiPage

WikiPage a wiki page

object

commit_count

integer format: int64

content_base64

Page content, base64 encoded

string

footer

string

html_url

string

last_commit

WikiCommit page commit/revision

object

author

CommitUser contains information of a user in the context of a commit.

object

date

string

email

string format: email

name

string

commiter

CommitUser contains information of a user in the context of a commit.

object

date

string

email

string format: email

name

string

message

string

sha

string

sidebar

string

sub_url

string

title

string

Example^generated

{
  "commit_count": 1,
  "content_base64": "example",
  "footer": "example",
  "html_url": "example",
  "last_commit": {
    "author": {
      "date": "example",
      "email": "hello@example.com",
      "name": "example"
    },
    "commiter": {
      "date": "example",
      "email": "hello@example.com",
      "name": "example"
    },
    "message": "example",
    "sha": "example"
  },
  "sidebar": "example",
  "sub_url": "example",
  "title": "example"
}

WikiPage a wiki page

object

commit_count

integer format: int64

content_base64

Page content, base64 encoded

string

footer

string

html_url

string

last_commit

WikiCommit page commit/revision

object

author

CommitUser contains information of a user in the context of a commit.

object

date

string

email

string format: email

name

string

commiter

CommitUser contains information of a user in the context of a commit.

object

date

string

email

string format: email

name

string

message

string

sha

string

sidebar

string

sub_url

string

title

string

400

APIError is error format response

Headers

message

string

url

string

403

APIForbiddenError is a forbidden error response

Headers

message

string

url

string

404

APINotFound is a not found empty response

423

APIRepoArchivedError is an error that is raised when an archived repo should be modified

Headers

message

string

url

string