Put wiki page | Softmax docs

PUT/v2/wikis/{wiki_slug}/pages/{page_slug}

Creates a page or adds a revision when the supplied base is current. A stale base returns 409; retrying the same idempotency key returns the original result.

Authorization

BearerAuth

AuthorizationBearer <token>

Bearer token issued by Softmax

In: header

Path Parameters

wiki_slug*Wiki Slug

Wiki slug.

page_slug*Page Slug

Page slug, including any nested path segments.

Match^(?:[a-z0-9]|[a-z0-9][a-z0-9_/-]*[a-z0-9_-])$

Length1 <= length <= 500

Request Body

application/json

title*Title

Page title to publish.

Length1 <= length <= 200

body*Body

Page body to publish.

Length1 <= length <= 100000

idempotency_key*Idempotency Key

Key that makes repeated edits return the same revision.

Length1 <= length <= 200

base_revision_id?|

Revision being replaced, or null when creating a new page.

note?|

Note explaining the edit.

bash

curl -X PUT "https://example.com/v2/wikis/string/pages/string" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "body": "string",
    "idempotency_key": "string"
  }'

json

{
  "page": {
    "id": "string",
    "wiki_id": "string",
    "slug": "string",
    "title": "string",
    "current_revision_id": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "deleted_at": "2019-08-24T14:15:22Z"
  },
  "revision": {
    "id": "string",
    "page_id": "string",
    "body": "string",
    "author": {
      "type": "user",
      "user_id": "string",
      "name": "string",
      "karma": 0,
      "post_karma": 0,
      "comment_karma": 0
    },
    "note": "string",
    "parent_revision_id": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
}