GROWI REST API v3 (7.0.2-RC.0)

Download OpenAPI specification:Download

Authentication

api_key

Security scheme type: API Key
Query parameter name: access_token

adminHome

AppSettings

/app-settings

get app setting params

Authorizations:

Responses

200

Resources are available

get /app-settings
https://demo.growi.org/_api/v3/app-settings

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "appSettingsParams": { }
}

/app-settings/app-setting

Update app setting

Authorizations:
Request Body schema: application/json
title
string

site name show on page header and tilte of HTML

confidential
string

confidential show on page header

globalLang
string

language set when create user

isEmailPublishedForNewUser
boolean

default email show/hide setting when create user

fileUpload
boolean

enable upload file except image file

Responses

200

Succeeded to update app setting

put /app-settings/app-setting
https://demo.growi.org/_api/v3/app-settings/app-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "title": "string",
  • "confidential": "string",
  • "globalLang": "string",
  • "isEmailPublishedForNewUser": true,
  • "fileUpload": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "title": "string",
  • "confidential": "string",
  • "globalLang": "string",
  • "isEmailPublishedForNewUser": true,
  • "fileUpload": true
}

/app-settings/site-url-setting

Update site url setting

Authorizations:
Request Body schema: application/json
siteUrl
envSiteUrl
string

environment variable 'APP_SITE_URL'

Responses

200

Succeeded to update site url setting

put /app-settings/site-url-setting
https://demo.growi.org/_api/v3/app-settings/site-url-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "siteUrl": "string",
  • "envSiteUrl": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "siteUrl": "string",
  • "envSiteUrl": "string"
}

/app-settings/smtp-setting

Update smtp setting

Authorizations:
Request Body schema: application/json
smtpHost
string

host name of client's smtp server

smtpPort
string

port of client's smtp server

smtpUser
string

user name of client's smtp server

smtpPassword
string

password of client's smtp server

Responses

200

Succeeded to update smtp setting

put /app-settings/smtp-setting
https://demo.growi.org/_api/v3/app-settings/smtp-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "smtpHost": "string",
  • "smtpPort": "string",
  • "smtpUser": "string",
  • "smtpPassword": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "smtpHost": "string",
  • "smtpPort": "string",
  • "smtpUser": "string",
  • "smtpPassword": "string"
}

/app-settings/smtp-setting

Send test mail for smtp

Authorizations:

Responses

200

Succeeded to send test mail for smtp

post /app-settings/smtp-test
https://demo.growi.org/_api/v3/app-settings/smtp-test

/app-settings/ses-setting

Update ses setting

Authorizations:
Request Body schema: application/json
accessKeyId
string

accesskey id for authentification of AWS

secretAccessKey
string

secret key for authentification of AWS

Responses

200

Succeeded to update ses setting

put /app-settings/ses-setting
https://demo.growi.org/_api/v3/app-settings/ses-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "accessKeyId": "string",
  • "secretAccessKey": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "accessKeyId": "string",
  • "secretAccessKey": "string"
}

/app-settings/file-upload-setting

Update fileUploadSetting

Authorizations:
Request Body schema: application/json
fileUploadType
string

fileUploadType

s3Region
string

region of AWS S3

s3CustomEndpoint
string

custom endpoint of AWS S3

s3Bucket
string

AWS S3 bucket name

s3AccessKeyId
string

accesskey id for authentification of AWS

s3SecretAccessKey
string

secret key for authentification of AWS

s3ReferenceFileWithRelayMode
boolean

is enable internal stream system for s3 file request

gcsApiKeyJsonPath
string

apiKeyJsonPath of gcp

gcsBucket
string

bucket name of gcs

gcsUploadNamespace
string

name space of gcs

gcsReferenceFileWithRelayMode
boolean

is enable internal stream system for gcs file request

envGcsApiKeyJsonPath
string

Path of the JSON file that contains service account key to authenticate to GCP API

envGcsBucket
string

Name of the GCS bucket

envGcsUploadNamespace
string

Directory name to create in the bucket

Responses

200

Succeeded to update fileUploadSetting

put /app-settings/file-upload-settings
https://demo.growi.org/_api/v3/app-settings/file-upload-settings

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fileUploadType": "string",
  • "s3Region": "string",
  • "s3CustomEndpoint": "string",
  • "s3Bucket": "string",
  • "s3AccessKeyId": "string",
  • "s3SecretAccessKey": "string",
  • "s3ReferenceFileWithRelayMode": true,
  • "gcsApiKeyJsonPath": "string",
  • "gcsBucket": "string",
  • "gcsUploadNamespace": "string",
  • "gcsReferenceFileWithRelayMode": true,
  • "envGcsApiKeyJsonPath": "string",
  • "envGcsBucket": "string",
  • "envGcsUploadNamespace": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fileUploadType": "string",
  • "s3Region": "string",
  • "s3CustomEndpoint": "string",
  • "s3Bucket": "string",
  • "s3AccessKeyId": "string",
  • "s3SecretAccessKey": "string",
  • "s3ReferenceFileWithRelayMode": true,
  • "gcsApiKeyJsonPath": "string",
  • "gcsBucket": "string",
  • "gcsUploadNamespace": "string",
  • "gcsReferenceFileWithRelayMode": true,
  • "envGcsApiKeyJsonPath": "string",
  • "envGcsBucket": "string",
  • "envGcsUploadNamespace": "string"
}

Attachment

Get attachment list

Get attachment list

Authorizations:
query Parameters
page_id
required
string

page id

Responses

200

Return attachment list

get /attachment/list
https://demo.growi.org/_api/v3/attachment/list

/attachment/limit

Get available capacity of uploaded file with GridFS

Authorizations:
query Parameters
fileSize
required
number
Example: fileSize=23175

file size

Responses

200

Succeeded to get available capacity of uploaded file with GridFS.

403

Forbidden

500

Internal Server Error

get /attachment/limit
https://demo.growi.org/_api/v3/attachment/limit

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isUploadable": true
}

/attachment

Add attachment to the page

Authorizations:
Request Body schema:
page_id
string Nullable
path
string Nullable
file
string <binary>

attachment data

Responses

200

Succeeded to add attachment.

403

Forbidden

500

Internal Server Error

post /attachment
https://demo.growi.org/_api/v3/attachment

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "page":
    {
    },
  • "attachment":
    {
    },
  • "pageCreated": false
}

Get attachment

Get attachment

Authorizations:
path Parameters
id
required
string

attachment id

Responses

200

Return attachment

get /attachment/{id}
https://demo.growi.org/_api/v3/attachment/{id}

Bookmarks

/bookmarks/info

Get bookmarked info

Authorizations:
query Parameters
pageId
string

page id

Responses

200

Succeeded to get bookmark info.

get /bookmarks/info
https://demo.growi.org/_api/v3/bookmarks/info

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "sumOfBookmarks": 0,
  • "isBookmarked": true
}

/bookmarks/{userId}

Get my bookmarked status

Authorizations:
path Parameters
userId
required
string

user id

query Parameters
page
number

selected page number

limit
number

page item limit

offset
number

page item offset

Responses

200

Succeeded to get my bookmarked status.

get /bookmarks/{userId}
https://demo.growi.org/_api/v3/bookmarks/{userId}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "_id": "5e07345972560e001761fa63",
  • "__v": 0,
  • "createdAt": "2010-01-01T00:00:00.000Z",
  • "page": "5e07345972560e001761fa63",
  • "user": "5ae5fccfc5577b0004dbd8ab"
}

/bookmarks

Update bookmarked status

Authorizations:
Request Body schema: application/json
pageId
string

page ID

bool
boolean

boolean for bookmark status

Responses

200

Succeeded to update bookmarked status.

put /bookmarks
https://demo.growi.org/_api/v3/bookmarks

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63",
  • "bool": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "_id": "5e07345972560e001761fa63",
  • "__v": 0,
  • "createdAt": "2010-01-01T00:00:00.000Z",
  • "page": "5e07345972560e001761fa63",
  • "user": "5ae5fccfc5577b0004dbd8ab"
}

CustomizeSetting

/customize-setting

Get customize parameters

Authorizations:

Responses

200

params of customize

get /customize-setting
https://demo.growi.org/_api/v3/customize-setting

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeParams": { }
}

/customize-setting/layout

Get layout

Authorizations:

Responses

200

Succeeded to get layout

get /customize-setting/layout
https://demo.growi.org/_api/v3/customize-setting/layout

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isContainerFluid": true
}

/customize-setting/layout

Update layout

Authorizations:
Request Body schema: application/json
isContainerFluid
boolean

Responses

200

Succeeded to update layout

put /customize-setting/layout
https://demo.growi.org/_api/v3/customize-setting/layout

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isContainerFluid": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isContainerFluid": true
}

/customize-setting/theme

Update theme

Authorizations:
Request Body schema: application/json
themeType
string

Responses

200

Succeeded to update theme

put /customize-setting/theme
https://demo.growi.org/_api/v3/customize-setting/theme

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "themeType": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "themeType": "string"
}

/customize-setting/function

Update function

Authorizations:
Request Body schema: application/json
isEnabledTimeline
boolean
isEnabledAttachTitleHeader
boolean
pageLimitationS
number
pageLimitationM
number
isEnabledStaleNotification
boolean
isAllReplyShown
boolean
isSearchScopeChildrenAsDefault
boolean

Responses

200

Succeeded to update function

put /customize-setting/function
https://demo.growi.org/_api/v3/customize-setting/function

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabledTimeline": true,
  • "isEnabledAttachTitleHeader": true,
  • "pageLimitationS": 0,
  • "pageLimitationM": 0,
  • "isEnabledStaleNotification": true,
  • "isAllReplyShown": true,
  • "isSearchScopeChildrenAsDefault": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabledTimeline": true,
  • "isEnabledAttachTitleHeader": true,
  • "pageLimitationS": 0,
  • "pageLimitationM": 0,
  • "isEnabledStaleNotification": true,
  • "isAllReplyShown": true,
  • "isSearchScopeChildrenAsDefault": true
}

/customize-setting/highlight

Update highlight

Authorizations:
Request Body schema: application/json
styleName
string
styleBorder
boolean

Responses

200

Succeeded to update highlight

put /customize-setting/highlight
https://demo.growi.org/_api/v3/customize-setting/highlight

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "styleName": "string",
  • "styleBorder": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "styleName": "string",
  • "styleBorder": true
}

/customize-setting/customizeTitle

Update customizeTitle

Authorizations:
Request Body schema: application/json
customizeTitle
string

Responses

200

Succeeded to update customizeTitle

put /customize-setting/customizeTitle
https://demo.growi.org/_api/v3/customize-setting/customizeTitle

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeTitle": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeTitle": "string"
}

/customize-setting/customize-noscript

Update customizeNoscript

Authorizations:
Request Body schema: application/json
customizeNoscript
string

Responses

200

Succeeded to update customize header

put /customize-setting/customize-noscript
https://demo.growi.org/_api/v3/customize-setting/customize-noscript

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeNoscript": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeNoscript": "string"
}

/customize-setting/customizeCss

Update customizeCss

Authorizations:
Request Body schema: application/json
customizeCss
string

Responses

200

Succeeded to update customize css

put /customize-setting/customizeCss
https://demo.growi.org/_api/v3/customize-setting/customizeCss

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeCss": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeCss": "string"
}

/customize-setting/customizeScript

Update customizeScript

Authorizations:
Request Body schema: application/json
customizeScript
string

Responses

200

Succeeded to update customize script

put /customize-setting/customizeScript
https://demo.growi.org/_api/v3/customize-setting/customizeScript

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeScript": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "customizeScript": "string"
}

Export

/export/status

get properties of stored zip files for export

Authorizations:

Responses

200

the zip file statuses

get /export/status
https://demo.growi.org/_api/v3/export/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "status":
    {
    }
}

/export

generate zipped jsons for collections

Authorizations:

Responses

200

a zip file is generated

post /export
https://demo.growi.org/_api/v3/export

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "status":
    {
    }
}

/export/{fileName}

delete the file

Authorizations:
path Parameters
fileName
required
string

the file name of zip file

Responses

200

the file is deleted

delete /export/{fileName}
https://demo.growi.org/_api/v3/export/{fileName}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{ }

return page's markdown

return page's markdown

Authorizations:

Responses

200

Return page's markdown

get /pages/export
https://demo.growi.org/_api/v3/pages/export

Healthcheck

/healthcheck

Check whether the server is healthy or not

Authorizations:
query Parameters
checkServices
Array of strings
Items Enum: "mongo" "search"

The list of services to check health

strictly
boolean

Check services and responds 503 if either of these is unhealthy

Responses

200

Healthy

503

Unhealthy

get /healthcheck
https://demo.growi.org/_api/v3/healthcheck

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "info":
    {
    }
}

Import

/import

Get import settings params

Authorizations:

Responses

200

import settings params

get /import
https://demo.growi.org/_api/v3/import

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "importSettingsParams": { }
}

/import

import a collection from a zipped json

Authorizations:
Request Body schema: application/json
fileName
string

the file name of zip file

collections
Array of strings

collection names to import

optionsMap
object

the map object of importing option that have collection name as the key

Responses

200

Import process has requested

post /import
https://demo.growi.org/_api/v3/import

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "fileName": "string",
  • "collections":
    [
    ],
  • "optionsMap":
    {
    }
}

/import/status

Get properties of stored zip files for import

Authorizations:

Responses

200

the zip file statuses

get /import/status
https://demo.growi.org/_api/v3/import/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "status":
    {
    }
}

/import/upload

upload a zip file

Authorizations:

Responses

200

the file is uploaded

post /import/upload
https://demo.growi.org/_api/v3/import/upload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "meta": { },
  • "fileName": "string",
  • "fileStats":
    [
    ]
}

/import/all

Delete all zip files

Authorizations:

Responses

200

all files are deleted

delete /import/all
https://demo.growi.org/_api/v3/import/all

MarkDownSetting

/markdown-setting

Get markdown parameters

Authorizations:

Responses

200

params of markdown

get /markdown-setting
https://demo.growi.org/_api/v3/markdown-setting

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "markdownParams": { }
}

/markdown-setting/lineBreak

Update lineBreak setting

Authorizations:
Request Body schema: application/json
isEnabledLinebreaks
boolean

enable lineBreak

isEnabledLinebreaksInComments
boolean

enable lineBreak in comment

Responses

200

Succeeded to update lineBreak setting

put /markdown-setting/lineBreak
https://demo.growi.org/_api/v3/markdown-setting/lineBreak

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabledLinebreaks": true,
  • "isEnabledLinebreaksInComments": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabledLinebreaks": true,
  • "isEnabledLinebreaksInComments": true
}

/markdown-setting/xss

Update xss

Authorizations:
Request Body schema: application/json
isEnabledPrevention
boolean

enable xss

xssOption
number

number of xss option

tagWhitelist
Array of strings

array of tag whitelist

attrWhitelist
Array of strings

array of attr whitelist

Responses

200

Succeeded to update xss setting

put /markdown-setting/xss
https://demo.growi.org/_api/v3/markdown-setting/xss

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabledPrevention": true,
  • "xssOption": 0,
  • "tagWhitelist":
    [
    ],
  • "attrWhitelist":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabledPrevention": true,
  • "xssOption": 0,
  • "tagWhitelist":
    [
    ],
  • "attrWhitelist":
    [
    ]
}

Mongo

/mongo/collections

get mongodb collections names

Authorizations:

Responses

200

a list of collections in mongoDB

get /mongo/collections
https://demo.growi.org/_api/v3/mongo/collections

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "collections":
    [
    ]
}

NotificationSetting

Get notification paramators

Get notification paramators

Authorizations:

Responses

200

params of notification

get /notification-setting/
https://demo.growi.org/_api/v3/notification-setting/

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "notificationParams": { }
}

add user notification setting

add user notification setting

Authorizations:
Request Body schema: application/json
pathPattern
string

path name of wiki

channel
string

slack channel name without '#'

Responses

200

Succeeded to add user notification setting

post /notification-setting/user-notification
https://demo.growi.org/_api/v3/notification-setting/user-notification

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pathPattern": "string",
  • "channel": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "createdUser": { },
  • "userNotifications": { }
}

delete user trigger notification pattern

delete user trigger notification pattern

Authorizations:
path Parameters
id
required
string

id of user trigger notification

Responses

200

Succeeded to delete user trigger notification pattern

delete /notification-setting/user-notification/{id}
https://demo.growi.org/_api/v3/notification-setting/user-notification/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "deletedNotificaton": { }
}

add global notification

add global notification

Authorizations:
Request Body schema: application/json
notifyType
string

What is type for notify

toEmail
string

email for notify

slackChannels
string

channels for notify

triggerPath
string

trigger path for notify

triggerEvents
Array of strings

Responses

200

Succeeded to add global notification

post /notification-setting/global-notification
https://demo.growi.org/_api/v3/notification-setting/global-notification

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "notifyType": "string",
  • "toEmail": "string",
  • "slackChannels": "string",
  • "triggerPath": "string",
  • "triggerEvents":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "createdNotification": { }
}

update global notification

update global notification

Authorizations:
path Parameters
id
required
string

global notification id for updated

Request Body schema: application/json
notifyType
string

What is type for notify

toEmail
string

email for notify

slackChannels
string

channels for notify

triggerPath
string

trigger path for notify

triggerEvents
Array of strings

Responses

200

Succeeded to update global notification

put /notification-setting/global-notification/{id}
https://demo.growi.org/_api/v3/notification-setting/global-notification/{id}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "notifyType": "string",
  • "toEmail": "string",
  • "slackChannels": "string",
  • "triggerPath": "string",
  • "triggerEvents":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "createdNotification": { }
}

delete global notification pattern

delete global notification pattern

Authorizations:
path Parameters
id
required
string

id of global notification

Responses

200

Succeeded to delete global notification pattern

delete /notification-setting/global-notification/{id}
https://demo.growi.org/_api/v3/notification-setting/global-notification/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "deletedNotificaton": { }
}

Update settings for notify for page grant

Update settings for notify for page grant

Authorizations:
Request Body schema: application/json
isNotificationForOwnerPageEnabled
string

Whether to notify on owner page

isNotificationForGroupPageEnabled
string

Whether to notify on group page

Responses

200

Succeeded to settings for notify for page grant

put /notification-setting/notify-for-page-grant
https://demo.growi.org/_api/v3/notification-setting/notify-for-page-grant

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNotificationForOwnerPageEnabled": "string",
  • "isNotificationForGroupPageEnabled": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNotificationForOwnerPageEnabled": "string",
  • "isNotificationForGroupPageEnabled": "string"
}

toggle enabled global notification

toggle enabled global notification

Authorizations:
path Parameters
id
required
string

notification id for updated

Request Body schema: application/json
isEnabled
boolean

is notification enabled

Responses

200

Succeeded to delete global notification pattern

put /notification-setting/global-notification/{id}/enabled
https://demo.growi.org/_api/v3/notification-setting/global-notification/{id}/enabled

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabled": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "deletedNotificaton": { }
}

Page

/page

get page by pagePath or pageId

Authorizations:
query Parameters
pageId
string
Example: pageId=5e07345972560e001761fa63

page id

path
string
Example: path=%2F

page path

Responses

200

Page data

get /page
https://demo.growi.org/_api/v3/page

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "_id": "5e07345972560e001761fa63",
  • "__v": 0,
  • "commentCount": 3,
  • "createdAt": "2010-01-01T00:00:00.000Z",
  • "creator":
    {
    },
  • "extended": { },
  • "grant": 1,
  • "grantedUsers":
    [
    ],
  • "lastUpdateUser":
    {
    },
  • "liker": [ ],
  • "path": "/",
  • "revision":
    {
    },
  • "status": "published",
  • "updatedAt": "2010-01-01T00:00:00.000Z"
}

createPage

Create page

Authorizations:
Request Body schema: application/json
body
required
string

Text of page

path
required
string

page path

grant
number

grant

grantUserGroupId
string

UserGroup ID

pageTags
Array of objects (Tag)
shouldGeneratePath
boolean

Determine whether a new path should be generated

Responses

201

Succeeded to create page.

409

page path is already existed

post /page
https://demo.growi.org/_api/v3/page

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "body": "string",
  • "path": "/",
  • "grant": 1,
  • "grantUserGroupId": "5ae5fccfc5577b0004dbd8ab",
  • "pageTags":
    [
    ],
  • "shouldGeneratePath": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "data":
    {
    }
}

updatePage

Update page

Authorizations:
Request Body schema: application/json
body
required
string

content body

page_id
required
string

page ID

revision_id
required
string

revision ID

grant
number

grant

Responses

200

Succeeded to update page.

403

Forbidden

500

Internal Server Error

put /page
https://demo.growi.org/_api/v3/page

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "body": "# test test ",
  • "page_id": "5e07345972560e001761fa63",
  • "revision_id": "5e0734e472560e001761fa68",
  • "grant": 1
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "data":
    {
    }
}

/page/likes

Update liked status

Authorizations:
Request Body schema: application/json
pageId
string

page ID

bool
boolean

boolean for like status

Responses

200

Succeeded to update liked status.

put /page/likes
https://demo.growi.org/_api/v3/page/likes

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63",
  • "bool": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "_id": "5e07345972560e001761fa63",
  • "__v": 0,
  • "commentCount": 3,
  • "createdAt": "2010-01-01T00:00:00.000Z",
  • "creator":
    {
    },
  • "extended": { },
  • "grant": 1,
  • "grantedUsers":
    [
    ],
  • "lastUpdateUser":
    {
    },
  • "liker": [ ],
  • "path": "/",
  • "revision":
    {
    },
  • "status": "published",
  • "updatedAt": "2010-01-01T00:00:00.000Z"
}

/page/info

Retrieve current page info

Authorizations:
Request Body schema: application/json
pageId
required
string

page ID

Responses

200

Successfully retrieved current page info.

500

Internal server error.

get /page/info
https://demo.growi.org/_api/v3/page/info

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isLiked": true,
  • "sumOfLikers": 0,
  • "likerIds":
    [
    ],
  • "sumOfSeenUsers": 0,
  • "seenUserIds":
    [
    ]
}

/page/info

Retrieve current page's isGrantNormalized value

Authorizations:
query Parameters
pageId
string
Example: pageId=5e07345972560e001761fa63

page id

Responses

200

Successfully retrieved current isGrantNormalized.

400

Bad request. Page is unreachable or empty.

500

Internal server error.

get /page/is-grant-normalized
https://demo.growi.org/_api/v3/page/is-grant-normalized

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isGrantNormalized": true
}

/page/exist-paths

Get already exist paths

Authorizations:
query Parameters
fromPath
string

old parent path

toPath
string

new parent path

Responses

200

Succeeded to retrieve pages.

500

Internal server error.

get /page/exist-paths
https://demo.growi.org/_api/v3/page/exist-paths

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "existPaths": { }
}

/page/subscribe

Update subscription status

Authorizations:
Request Body schema: application/json
pageId
string

page ID

Responses

200

Succeeded to update subscription status.

500

Internal server error.

put /page/subscribe
https://demo.growi.org/_api/v3/page/subscribe

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "_id": "5e07345972560e001761fa63",
  • "__v": 0,
  • "commentCount": 3,
  • "createdAt": "2010-01-01T00:00:00.000Z",
  • "creator":
    {
    },
  • "extended": { },
  • "grant": 1,
  • "grantedUsers":
    [
    ],
  • "lastUpdateUser":
    {
    },
  • "liker": [ ],
  • "path": "/",
  • "revision":
    {
    },
  • "status": "published",
  • "updatedAt": "2010-01-01T00:00:00.000Z"
}

Pages

Get recently updated pages

Get recently updated pages

Authorizations:

Responses

200

Return pages recently updated

get /pages/recent
https://demo.growi.org/_api/v3/pages/recent

renamePage

Rename page

Authorizations:
Request Body schema: application/json
pageId
required
string

page ID

path
string

page path

revisionId
required
string

revision ID

newPagePath
string

new path

isRenameRedirect
boolean

whether redirect page

updateMetadata
boolean

whether update meta data

isRecursively
boolean

whether rename page with descendants

Responses

200

Succeeded to rename page.

401

page id is invalid

409

page path is already existed

post /pages/rename
https://demo.growi.org/_api/v3/pages/rename

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63",
  • "path": "/",
  • "revisionId": "5e07345972560e001761fa63",
  • "newPagePath": "/user/alice/new_test",
  • "isRenameRedirect": true,
  • "updateMetadata": true,
  • "isRecursively": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "page":
    {
    }
}

empty trash

empty trash

Authorizations:

Responses

200

Succeeded to remove all trash pages

delete /pages/empty-trash
https://demo.growi.org/_api/v3/pages/empty-trash

duplicatePage

Duplicate page

Authorizations:
Request Body schema: application/json
pageId
required
string

page ID

pageNameInput
string

page path

isRecursively
boolean

whether duplicate page with descendants

Responses

200

Succeeded to duplicate page.

403

Forbidden to duplicate page.

500

Internal server error.

post /pages/duplicate
https://demo.growi.org/_api/v3/pages/duplicate

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63",
  • "pageNameInput": "/",
  • "isRecursively": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "page":
    {
    }
}

subordinatedList

Get subordinated pages

Authorizations:
query Parameters
path
string

Parent path of search

limit
number

Limit of acquisitions

Responses

200

Succeeded to retrieve pages.

500

Internal server error.

get /pages/subordinated-list
https://demo.growi.org/_api/v3/pages/subordinated-list

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "subordinatedPaths": { }
}

/pages.getPageTag

Get page tag

Authorizations:
query Parameters
pageId
string
Example: pageId=5e07345972560e001761fa63

page ID

Responses

200

Succeeded to get page tags.

403

Forbidden

500

Internal Server Error

get /pages.getPageTag
https://demo.growi.org/_api/v3/pages.getPageTag

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "tags":
    [
    ]
}

/pages.updatePost

Get UpdatePost setting list

Authorizations:
query Parameters
path
string
Example: path=%2F

page path

Responses

200

Succeeded to get UpdatePost setting list.

403

Forbidden

500

Internal Server Error

get /pages.updatePost
https://demo.growi.org/_api/v3/pages.updatePost

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "updatePost":
    {
    }
}

PersonalSetting

/personal-setting

Get personal parameters

Authorizations:

Responses

200

params of personal

get /personal-setting
https://demo.growi.org/_api/v3/personal-setting

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentUser": { }
}

/personal-setting

Update personal setting

Authorizations:
Request Body schema: application/json
name
string
email
string
lang
string
isEmailPublished
boolean

Responses

200

params of personal

put /personal-setting
https://demo.growi.org/_api/v3/personal-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "string",
  • "email": "string",
  • "lang": "string",
  • "isEmailPublished": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentUser": { }
}

/personal-setting

Get whether a password has been set

Authorizations:

Responses

200

Whether a password has been set

get /personal-setting/is-password-set
https://demo.growi.org/_api/v3/personal-setting/is-password-set

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isPasswordSet": true
}

/personal-setting/image-type

Update user image type

Authorizations:

Responses

200

succeded to update user image type

put /personal-setting/image-type
https://demo.growi.org/_api/v3/personal-setting/image-type

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/personal-setting/external-accounts

Get external accounts that linked current user

Authorizations:

Responses

200

external accounts

get /personal-setting/external-accounts
https://demo.growi.org/_api/v3/personal-setting/external-accounts

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "externalAccounts": { }
}

/personal-setting/password

Update user password

Authorizations:
Request Body schema: application/json
oldPassword
string
newPassword
string
newPasswordConfirm
string

Responses

200

user password

put /personal-setting/password
https://demo.growi.org/_api/v3/personal-setting/password

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oldPassword": "string",
  • "newPassword": "string",
  • "newPasswordConfirm": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/personal-setting/api-token

Update user api token

Authorizations:

Responses

200

succeded to update user api token

put /personal-setting/api-token
https://demo.growi.org/_api/v3/personal-setting/api-token

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/personal-setting/associate-ldap

associate Ldap account

Authorizations:
Request Body schema: application/json
username
string
password
string

Responses

200

succeded to associate Ldap account

put /personal-setting/associate-ldap
https://demo.growi.org/_api/v3/personal-setting/associate-ldap

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "username": "string",
  • "password": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "associateUser": { }
}

/personal-setting/disassociate-ldap

disassociate Ldap account

Authorizations:
Request Body schema: application/json
providerType
string
accountId
string

Responses

200

succeded to disassociate Ldap account

put /personal-setting/disassociate-ldap
https://demo.growi.org/_api/v3/personal-setting/disassociate-ldap

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "providerType": "string",
  • "accountId": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "disassociateUser": { }
}

Revisions

Get revisions by page id

Get revisions by page id

Authorizations:
query Parameters
pageId
string

page id

page
number

selected page number

limit
number

page item limit

Responses

200

Return revisions belong to page

get /revisions/list
https://demo.growi.org/_api/v3/revisions/list

Get one revision by id

Get one revision by id

Authorizations:
path Parameters
id
required
string

revision id

query Parameters
pageId
required
string

page id

Responses

200

Return revision

get /revisions/{id}
https://demo.growi.org/_api/v3/revisions/{id}

Search

/search/indices

Get current status of indices

Authorizations:

Responses

200

Status of indices

get /search/indices
https://demo.growi.org/_api/v3/search/indices

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "info": { }
}

/search/indices

Operate indices

Authorizations:
Request Body schema: application/json
operation
string
Enum: "normalize" "rebuild"

Operation type against to indices > * normalize - Normalize indices * rebuild - Rebuild indices

Responses

200

Return 200

put /search/indices
https://demo.growi.org/_api/v3/search/indices

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "operation": "normalize"
}

/search/connection

Reconnect to Elasticsearch

Authorizations:

Responses

200

Successfully connected

get /search/connection
https://demo.growi.org/_api/v3/search/connection

SecuritySetting

Get security paramators

Get security paramators

Authorizations:

Responses

200

params of security

get /_api/v3/security-setting/
https://demo.growi.org/_api/v3/_api/v3/security-setting/

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "securityParams": { }
}

Update authentication isEnabled

Update authentication isEnabled

Authorizations:
Request Body schema: application/json
isEnabled
boolean
target
string

Responses

200

Succeeded to enable authentication

put /_api/v3/security-setting/authentication/enabled
https://demo.growi.org/_api/v3/_api/v3/security-setting/authentication/enabled

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabled": true,
  • "target": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{ }

Get setup strategies for passport

Get setup strategies for passport

Authorizations:

Responses

200

params of setup strategies

get /_api/v3/security-setting/authentication
https://demo.growi.org/_api/v3/_api/v3/security-setting/authentication

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "setupStrategies":
    [
    ]
}

Update GeneralSetting

Update GeneralSetting

Authorizations:
Request Body schema: application/json
restrictGuestMode
string

type of restrictGuestMode

pageCompleteDeletionAuthority
string

type of pageDeletionAuthority

hideRestrictedByOwner
boolean

enable hide by owner

hideRestrictedByGroup
boolean

enable hide by group

Responses

200

Succeeded to update general Setting

put /_api/v3/security-setting/general-setting
https://demo.growi.org/_api/v3/_api/v3/security-setting/general-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "restrictGuestMode": "string",
  • "pageCompleteDeletionAuthority": "string",
  • "hideRestrictedByOwner": true,
  • "hideRestrictedByGroup": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "restrictGuestMode": "string",
  • "pageCompleteDeletionAuthority": "string",
  • "hideRestrictedByOwner": true,
  • "hideRestrictedByGroup": true
}

Update LDAP setting

Update LDAP setting

Authorizations:
Request Body schema: application/json
serverUrl
string

server url for ldap

isUserBind
boolean

enable user bind

ldapBindDN
string

the query used to bind with the directory service

ldapBindDNPassword
string

the password that is entered in the login page will be used to bind

ldapSearchFilter
string

the query used to locate the authenticated user

ldapAttrMapUsername
string

specification of mappings for username when creating new users

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the user name matched

ldapAttrMapMail
string

specification of mappings for mail address when creating new users

ldapAttrMapName
string

Specification of mappings for full name address when creating new users

ldapGroupSearchBase
string

the base DN from which to search for groups.

ldapGroupSearchFilter
string

the query used to filter for groups

ldapGroupDnProperty
string

The property of user object to use in dn interpolation of Group Search Filter

Responses

200

Succeeded to update LDAP setting

put /_api/v3/security-setting/ldap
https://demo.growi.org/_api/v3/_api/v3/security-setting/ldap

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverUrl": "string",
  • "isUserBind": true,
  • "ldapBindDN": "string",
  • "ldapBindDNPassword": "string",
  • "ldapSearchFilter": "string",
  • "ldapAttrMapUsername": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "ldapAttrMapMail": "string",
  • "ldapAttrMapName": "string",
  • "ldapGroupSearchBase": "string",
  • "ldapGroupSearchFilter": "string",
  • "ldapGroupDnProperty": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverUrl": "string",
  • "isUserBind": true,
  • "ldapBindDN": "string",
  • "ldapBindDNPassword": "string",
  • "ldapSearchFilter": "string",
  • "ldapAttrMapUsername": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "ldapAttrMapMail": "string",
  • "ldapAttrMapName": "string",
  • "ldapGroupSearchBase": "string",
  • "ldapGroupSearchFilter": "string",
  • "ldapGroupDnProperty": "string"
}

Update SAML setting

Update SAML setting

Authorizations:
Request Body schema: application/json
samlEntryPoint
string

entry point for saml

samlIssuer
string

issuer for saml

samlCert
string

certificate for saml

samlAttrMapId
string

attribute mapping id for saml

samlAttrMapUserName
string

attribute mapping user name for saml

samlAttrMapMail
string

attribute mapping mail for saml

samlAttrMapFirstName
string

attribute mapping first name for saml

samlAttrMapLastName
string

attribute mapping last name for saml

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the user name matched

isSameEmailTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

samlABLCRule
string

ABLCRule for saml

Responses

200

Succeeded to update SAML setting

put /_api/v3/security-setting/saml
https://demo.growi.org/_api/v3/_api/v3/security-setting/saml

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "samlEntryPoint": "string",
  • "samlIssuer": "string",
  • "samlCert": "string",
  • "samlAttrMapId": "string",
  • "samlAttrMapUserName": "string",
  • "samlAttrMapMail": "string",
  • "samlAttrMapFirstName": "string",
  • "samlAttrMapLastName": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true,
  • "samlABLCRule": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "samlEntryPoint": "string",
  • "samlIssuer": "string",
  • "samlCert": "string",
  • "samlAttrMapId": "string",
  • "samlAttrMapUserName": "string",
  • "samlAttrMapMail": "string",
  • "samlAttrMapFirstName": "string",
  • "samlAttrMapLastName": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true,
  • "samlABLCRule": "string"
}

Update OpenID Connect setting

Update OpenID Connect setting

Authorizations:
Request Body schema: application/json
oidcProviderName
string

provider name for oidc

oidcIssuerHost
string

issuer host for oidc

oidcAuthorizationEndpoint
string

authorization endpoint for oidc

oidcTokenEndpoint
string

token endpoint for oidc

oidcRevocationEndpoint
string

revocation endpoint for oidc

oidcIntrospectionEndpoint
string

introspection endpoint for oidc

oidcUserInfoEndpoint
string

userinfo endpoint for oidc

oidcEndSessionEndpoint
string

end session endpoint for oidc

oidcRegistrationEndpoint
string

registration endpoint for oidc

oidcJWKSUri
string

JSON Web Key Set URI for oidc

oidcClientId
string

client id for oidc

oidcClientSecret
string

client secret for oidc

oidcAttrMapId
string

attr map id for oidc

oidcAttrMapUserName
string

attr map username for oidc

oidcAttrMapName
string

attr map name for oidc

oidcAttrMapMail
string

attr map mail for oidc

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the user name matched

isSameEmailTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

Responses

200

Succeeded to update OpenID Connect setting

put /_api/v3/security-setting/oidc
https://demo.growi.org/_api/v3/_api/v3/security-setting/oidc

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oidcProviderName": "string",
  • "oidcIssuerHost": "string",
  • "oidcAuthorizationEndpoint": "string",
  • "oidcTokenEndpoint": "string",
  • "oidcRevocationEndpoint": "string",
  • "oidcIntrospectionEndpoint": "string",
  • "oidcUserInfoEndpoint": "string",
  • "oidcEndSessionEndpoint": "string",
  • "oidcRegistrationEndpoint": "string",
  • "oidcJWKSUri": "string",
  • "oidcClientId": "string",
  • "oidcClientSecret": "string",
  • "oidcAttrMapId": "string",
  • "oidcAttrMapUserName": "string",
  • "oidcAttrMapName": "string",
  • "oidcAttrMapMail": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oidcProviderName": "string",
  • "oidcIssuerHost": "string",
  • "oidcAuthorizationEndpoint": "string",
  • "oidcTokenEndpoint": "string",
  • "oidcRevocationEndpoint": "string",
  • "oidcIntrospectionEndpoint": "string",
  • "oidcUserInfoEndpoint": "string",
  • "oidcEndSessionEndpoint": "string",
  • "oidcRegistrationEndpoint": "string",
  • "oidcJWKSUri": "string",
  • "oidcClientId": "string",
  • "oidcClientSecret": "string",
  • "oidcAttrMapId": "string",
  • "oidcAttrMapUserName": "string",
  • "oidcAttrMapName": "string",
  • "oidcAttrMapMail": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true
}

Update google OAuth

Update google OAuth

Authorizations:
Request Body schema: application/json
googleClientId
string

key of comsumer

googleClientSecret
string

password of comsumer

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

Responses

200

Succeeded to google OAuth

put /_api/v3/security-setting/google-oauth
https://demo.growi.org/_api/v3/_api/v3/security-setting/google-oauth

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "googleClientId": "string",
  • "googleClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "googleClientId": "string",
  • "googleClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

Update github OAuth

Update github OAuth

Authorizations:
Request Body schema: application/json
githubClientId
string

key of comsumer

githubClientSecret
string

password of comsumer

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

Responses

200

Succeeded to github OAuth

put /_api/v3/security-setting/github-oauth
https://demo.growi.org/_api/v3/_api/v3/security-setting/github-oauth

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "githubClientId": "string",
  • "githubClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "githubClientId": "string",
  • "githubClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

get share links

get share links

Authorizations:
query Parameters
relatedPage
required
string

page id of share link

Responses

200

Succeeded to get share links

get /share-links/
https://demo.growi.org/_api/v3/share-links/

Create new share link

Create new share link

Authorizations:
query Parameters
relatedPage
required
string

page id of share link

expiredAt
string

expiration date of share link

description
string

description of share link

Responses

200

Succeeded to create one share link

post /share-links/
https://demo.growi.org/_api/v3/share-links/

SlackIntegrationLegacySetting

Get slack configuration setting

Get slack configuration setting

Authorizations:

Responses

200

params of slack configuration setting

get /slack-integration-legacy-setting/
https://demo.growi.org/_api/v3/slack-integration-legacy-setting/

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "notificationParams": { }
}

Update slack configuration setting

Update slack configuration setting

Authorizations:
Request Body schema: application/json
webhookUrl
string

incoming webhooks url

isIncomingWebhookPrioritized
boolean

use incoming webhooks even if Slack App settings are enabled

slackToken
string

OAuth access token

Responses

200

Succeeded to update slack configuration setting

put /slack-integration-legacy-setting/
https://demo.growi.org/_api/v3/slack-integration-legacy-setting/

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "webhookUrl": "string",
  • "isIncomingWebhookPrioritized": true,
  • "slackToken": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "webhookUrl": "string",
  • "isIncomingWebhookPrioritized": true,
  • "slackToken": "string"
}

SlackIntegrationSettings

Statistics

/statistics/user

Get statistics for user

Authorizations:

Responses

200

Statistics for user

get /statistics/user
https://demo.growi.org/_api/v3/statistics/user

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "data": { }
}

UserGroupRelation

/user-group-relations

Gets the user group relations

Authorizations:

Responses

200

user group relations are fetched

get /user-group-relations
https://demo.growi.org/_api/v3/user-group-relations

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroupRelations": { }
}

UserGroup

/user-groups

Get usergroups

Authorizations:

Responses

200

usergroups are fetched

get /user-groups
https://demo.growi.org/_api/v3/user-groups

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroups": { }
}

/user-groups

Adds userGroup

Authorizations:
Request Body schema: application/json
name
string

name of the userGroup trying to be added

Responses

200

userGroup is added

post /user-groups
https://demo.growi.org/_api/v3/user-groups

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroup": { }
}

/ancestors

Get ancestor user groups.

Authorizations:
query Parameters
groupId
required
string

id of userGroup

Responses

200

userGroups are fetched

get /ancestors
https://demo.growi.org/_api/v3/ancestors

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroups":
    [
    ]
}

/selectable-parent-groups

Get selectable parent UserGroups

Authorizations:
query Parameters
groupId
required
string

id of userGroup

Responses

200

userGroups are fetched

get /selectable-parent-groups
https://demo.growi.org/_api/v3/selectable-parent-groups

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroups":
    [
    ]
}

/selectable-child-groups

Get selectable child UserGroups

Authorizations:
query Parameters
groupId
required
string

id of userGroup

Responses

200

userGroups are fetched

get /selectable-child-groups
https://demo.growi.org/_api/v3/selectable-child-groups

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroups":
    [
    ]
}

/user-groups/{id}

Get UserGroup from Group ID

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

userGroup are fetched

get /user-groups/{id}
https://demo.growi.org/_api/v3/user-groups/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroup": { }
}

/user-groups/{id}

Deletes userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

query Parameters
actionName
string

name of action

transferToUserGroupId
string

userGroup id that will be transferred to

Responses

200

userGroup is removed

delete /user-groups/{id}
https://demo.growi.org/_api/v3/user-groups/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroups": { }
}

/user-groups/{id}

Update userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

userGroup is updated

put /user-groups/{id}
https://demo.growi.org/_api/v3/user-groups/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroup": { }
}

/user-groups/{id}/users

Get users related to the userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

users are fetched

get /user-groups/{id}/users
https://demo.growi.org/_api/v3/user-groups/{id}/users

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "users":
    [
    ]
}

/user-groups/{id}/users

Add a user to the userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

a user is added

post /user-groups/{id}/users
https://demo.growi.org/_api/v3/user-groups/{id}/users

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "user": { },
  • "userGroup": { },
  • "userGroupRelation": { }
}

/user-groups/{id}/users

remove a user from the userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

a user was removed

delete /user-groups/{id}/users
https://demo.growi.org/_api/v3/user-groups/{id}/users

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "user": { },
  • "userGroup": { },
  • "userGroupRelation": { }
}

/user-groups/{id}/unrelated-users

Get users unrelated to the userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

users are fetched

get /user-groups/{id}/unrelated-users
https://demo.growi.org/_api/v3/user-groups/{id}/unrelated-users

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "users":
    [
    ]
}

/user-groups/{id}/user-group-relations

Get the user group relations for the userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

user group relations are fetched

get /user-groups/{id}/user-group-relations
https://demo.growi.org/_api/v3/user-groups/{id}/user-group-relations

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userGroupRelations":
    [
    ]
}

/user-groups/{id}/pages

Get closed pages for the userGroup

Authorizations:
path Parameters
id
required
string

id of userGroup

Responses

200

pages are fetched

get /user-groups/{id}/pages
https://demo.growi.org/_api/v3/user-groups/{id}/pages

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pages":
    [
    ]
}

Users

/users

Select selected columns from users order by asc or desc

Authorizations:
query Parameters
page
number

page number

selectedStatusList
string

status list

searchText
string

For incremental search value from input box

sortOrder
string

asc or desc

sort
string

sorting column

Responses

200

users are fetched

get /users
https://demo.growi.org/_api/v3/users

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "paginateResult":
    {
    }
}

/usersIdReacent

Authorizations:
path Parameters
id
required
string

id of user

Responses

200

users recent created pages are fetched

get /{id}/recent
https://demo.growi.org/_api/v3/{id}/recent

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "paginateResult":
    {
    }
}

/users/invite

Create new users and send Emails

Authorizations:
query Parameters
shapedEmailList
object

Invitation emailList

sendEmail
boolean

Whether to send mail

Responses

200

Inviting user success

post /users/invite
https://demo.growi.org/_api/v3/users/invite

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "createdUserList": { },
  • "existingEmailList": { },
  • "failedEmailList": { }
}

/users/{id}/grant-admin

Grant user admin

Authorizations:
path Parameters
id
required
string

id of user for admin

Responses

200

Grant user admin success

put /users/{id}/grant-admin
https://demo.growi.org/_api/v3/users/{id}/grant-admin

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/{id}/revoke-admin

Revoke user admin

Authorizations:
path Parameters
id
required
string

id of user for revoking admin

Responses

200

Revoke user admin success

put /users/{id}/revoke-admin
https://demo.growi.org/_api/v3/users/{id}/revoke-admin

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/{id}/grant-read-only

Grant user read only access

Authorizations:
path Parameters
id
required
string

id of user for read only access

Responses

200

Grant user read only access success

put /users/{id}/grant-read-only
https://demo.growi.org/_api/v3/users/{id}/grant-read-only

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/{id}/revoke-read-only

Revoke user read only access

Authorizations:
path Parameters
id
required
string

id of user for removing read only access

Responses

200

Revoke user read only access success

put /users/{id}/revoke-read-only
https://demo.growi.org/_api/v3/users/{id}/revoke-read-only

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/{id}/activate

Activate user

Authorizations:
path Parameters
id
required
string

id of activate user

Responses

200

Activationg user success

put /users/{id}/activate
https://demo.growi.org/_api/v3/users/{id}/activate

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/{id}/deactivate

Deactivate user

Authorizations:
path Parameters
id
required
string

id of deactivate user

Responses

200

Deactivationg user success

put /users/{id}/deactivate
https://demo.growi.org/_api/v3/users/{id}/deactivate

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/{id}/remove

Delete user

Authorizations:
path Parameters
id
required
string

id of delete user

Responses

200

Deleting user success

delete /users/{id}/remove
https://demo.growi.org/_api/v3/users/{id}/remove

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "user": { }
}

/users/external-accounts

Get external-account

Authorizations:

Responses

200

external-account are fetched

get /users/external-accounts
https://demo.growi.org/_api/v3/users/external-accounts

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "paginateResult":
    {
    }
}

/users/external-accounts/{id}/remove

Delete ExternalAccount

Authorizations:
path Parameters
id
required
string

id of ExternalAccount

Responses

200

External Account is removed

delete /users/external-accounts/{id}/remove
https://demo.growi.org/_api/v3/users/external-accounts/{id}/remove

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "externalAccount": { }
}

/users/update.imageUrlCache

update imageUrlCache

Authorizations:
query Parameters
userIds
string

user id list

Responses

200

success creating imageUrlCached

put /users/update.imageUrlCache
https://demo.growi.org/_api/v3/users/update.imageUrlCache

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "userData": { }
}

/users/reset-password

update imageUrlCache

Authorizations:
Request Body schema: application/json
newPassword
string
user
string

user id for reset password

Responses

200

success reset password

put /users/reset-password
https://demo.growi.org/_api/v3/users/reset-password

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "newPassword": "string",
  • "user": "string"
}

/users/reset-password-email

send new password email

Authorizations:
Request Body schema: application/json
newPassword
string
user
string

user id for send new password email

Responses

200

success send new password email

put /users/reset-password-email
https://demo.growi.org/_api/v3/users/reset-password-email

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "newPassword": "string",
  • "user": "string"
}

/users/send-invitation-email

send invitation email

Authorizations:
Request Body schema: application/json
id
string

user id for send invitation email

Responses

200

success send invitation email

put /users/send-invitation-email
https://demo.growi.org/_api/v3/users/send-invitation-email

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "failedToSendEmail": { }
}

/users/list

Get list of users

Authorizations:
query Parameters
userIds
string
Example: userIds=5e06fcc7516d64004dbf4da6%2C5e098d53baa2ac004e7d24ad

user IDs

Responses

200

Succeeded to get list of users.

403

Forbidden

500

Internal Server Error

get /users/list
https://demo.growi.org/_api/v3/users/list

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "users":
    [
    ]
}

Attachments

/attachments.uploadProfileImage

Upload profile image

Authorizations:
Request Body schema:
file
string <binary>

attachment data

user
string

user to set profile image

Responses

200

Succeeded to add attachment.

403

Forbidden

500

Internal Server Error

post /attachments.uploadProfileImage
https://demo.growi.org/_api/v3/attachments.uploadProfileImage

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "attachment":
    {
    }
}

/attachments.remove

Remove attachment

Authorizations:
Request Body schema: application/json
attachment_id
required
string

attachment ID

Responses

200

Succeeded to remove attachment.

403

Forbidden

500

Internal Server Error

post /attachments.remove
https://demo.growi.org/_api/v3/attachments.remove

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "attachment_id": "5e0734e072560e001761fa67"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true
}

/attachments.removeProfileImage

Remove profile image

Authorizations:
Request Body schema: application/json
user
string

user to remove profile image

Responses

200

Succeeded to add attachment.

403

Forbidden

500

Internal Server Error

post /attachments.removeProfileImage
https://demo.growi.org/_api/v3/attachments.removeProfileImage

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "user": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true
}

Comments

/comments.get

Get comments of the page of the revision

Authorizations:
query Parameters
page_id
string
Example: page_id=5e07345972560e001761fa63

page ID

revision_id
string
Example: revision_id=5e0734e472560e001761fa68

revision ID

Responses

200

Succeeded to get comments of the page of the revision.

403

Forbidden

500

Internal Server Error

get /comments.get
https://demo.growi.org/_api/v3/comments.get

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comments":
    [
    ]
}

/comments.add

Post comment for the page

Authorizations:
Request Body schema: application/json
commentForm
required
object

Responses

200

Succeeded to post comment for the page.

403

Forbidden

500

Internal Server Error

post /comments.add
https://demo.growi.org/_api/v3/comments.add

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "commentForm":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comment":
    {
    }
}

/comments.update

Update comment dody

Authorizations:
Request Body schema: application/json
form
required
object

Responses

200

Succeeded to update comment dody.

403

Forbidden

500

Internal Server Error

post /comments.update
https://demo.growi.org/_api/v3/comments.update

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "form":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comment":
    {
    }
}

/comments.remove

Remove specified comment

Authorizations:
Request Body schema: application/json
comment_id
required
string

revision ID

Responses

200

Succeeded to remove specified comment.

403

Forbidden

500

Internal Server Error

post /comments.remove
https://demo.growi.org/_api/v3/comments.remove

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "comment_id": "5e079a0a0afa6700170a75fb"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comment":
    {
    }
}

AdminHome

/admin-home

Get adminHome parameters

Authorizations:

Responses

200

params of adminHome

get /admin-home/
https://demo.growi.org/_api/v3/admin-home/

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "adminHomeParams": { }
}

CrowiCompatibles

/attachment

Add attachment to the page

Authorizations:
Request Body schema:
page_id
string Nullable
path
string Nullable
file
string <binary>

attachment data

Responses

200

Succeeded to add attachment.

403

Forbidden

500

Internal Server Error

post /attachment
https://demo.growi.org/_api/v3/attachment

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "page":
    {
    },
  • "attachment":
    {
    },
  • "pageCreated": false
}

/attachments.remove

Remove attachment

Authorizations:
Request Body schema: application/json
attachment_id
required
string

attachment ID

Responses

200

Succeeded to remove attachment.

403

Forbidden

500

Internal Server Error

post /attachments.remove
https://demo.growi.org/_api/v3/attachments.remove

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "attachment_id": "5e0734e072560e001761fa67"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true
}

/comments.get

Get comments of the page of the revision

Authorizations:
query Parameters
page_id
string
Example: page_id=5e07345972560e001761fa63

page ID

revision_id
string
Example: revision_id=5e0734e472560e001761fa68

revision ID

Responses

200

Succeeded to get comments of the page of the revision.

403

Forbidden

500

Internal Server Error

get /comments.get
https://demo.growi.org/_api/v3/comments.get

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comments":
    [
    ]
}

/comments.add

Post comment for the page

Authorizations:
Request Body schema: application/json
commentForm
required
object

Responses

200

Succeeded to post comment for the page.

403

Forbidden

500

Internal Server Error

post /comments.add
https://demo.growi.org/_api/v3/comments.add

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "commentForm":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comment":
    {
    }
}

/comments.update

Update comment dody

Authorizations:
Request Body schema: application/json
form
required
object

Responses

200

Succeeded to update comment dody.

403

Forbidden

500

Internal Server Error

post /comments.update
https://demo.growi.org/_api/v3/comments.update

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "form":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comment":
    {
    }
}

/comments.remove

Remove specified comment

Authorizations:
Request Body schema: application/json
comment_id
required
string

revision ID

Responses

200

Succeeded to remove specified comment.

403

Forbidden

500

Internal Server Error

post /comments.remove
https://demo.growi.org/_api/v3/comments.remove

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "comment_id": "5e079a0a0afa6700170a75fb"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "comment":
    {
    }
}

/pages.updatePost

Get UpdatePost setting list

Authorizations:
query Parameters
path
string
Example: path=%2F

page path

Responses

200

Succeeded to get UpdatePost setting list.

403

Forbidden

500

Internal Server Error

get /pages.updatePost
https://demo.growi.org/_api/v3/pages.updatePost

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "updatePost":
    {
    }
}

EditorSetting

/editor-setting

Put editor preferences

Authorizations:

Responses

200

params of editor settings

put /personal-setting/editor-settings
https://demo.growi.org/_api/v3/personal-setting/editor-settings

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentUser": { }
}

/editor-setting

Get editor preferences

Authorizations:

Responses

200

params of editor settings

get /personal-setting/editor-settings
https://demo.growi.org/_api/v3/personal-setting/editor-settings

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentUser": { }
}

in-app-notification-settings

personal-setting/in-app-notification-settings

Put InAppNotificationSettings

Authorizations:

Responses

200

params of InAppNotificationSettings

put /personal-setting/in-app-notification-settings
https://demo.growi.org/_api/v3/personal-setting/in-app-notification-settings

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentUser": { }
}

personal-setting/in-app-notification-settings

Get InAppNotificationSettings

Authorizations:

Responses

200

params of InAppNotificationSettings

get /personal-setting/in-app-notification-settings
https://demo.growi.org/_api/v3/personal-setting/in-app-notification-settings

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentUser": { }
}

apiv3

Get security paramators

Get security paramators

Authorizations:

Responses

200

params of security

get /_api/v3/security-setting/
https://demo.growi.org/_api/v3/_api/v3/security-setting/

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "securityParams": { }
}

Update authentication isEnabled

Update authentication isEnabled

Authorizations:
Request Body schema: application/json
isEnabled
boolean
target
string

Responses

200

Succeeded to enable authentication

put /_api/v3/security-setting/authentication/enabled
https://demo.growi.org/_api/v3/_api/v3/security-setting/authentication/enabled

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isEnabled": true,
  • "target": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{ }

Get setup strategies for passport

Get setup strategies for passport

Authorizations:

Responses

200

params of setup strategies

get /_api/v3/security-setting/authentication
https://demo.growi.org/_api/v3/_api/v3/security-setting/authentication

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "setupStrategies":
    [
    ]
}

Update GeneralSetting

Update GeneralSetting

Authorizations:
Request Body schema: application/json
restrictGuestMode
string

type of restrictGuestMode

pageCompleteDeletionAuthority
string

type of pageDeletionAuthority

hideRestrictedByOwner
boolean

enable hide by owner

hideRestrictedByGroup
boolean

enable hide by group

Responses

200

Succeeded to update general Setting

put /_api/v3/security-setting/general-setting
https://demo.growi.org/_api/v3/_api/v3/security-setting/general-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "restrictGuestMode": "string",
  • "pageCompleteDeletionAuthority": "string",
  • "hideRestrictedByOwner": true,
  • "hideRestrictedByGroup": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "restrictGuestMode": "string",
  • "pageCompleteDeletionAuthority": "string",
  • "hideRestrictedByOwner": true,
  • "hideRestrictedByGroup": true
}

Get All ShareLinks at Share Link Setting

Get All ShareLinks at Share Link Setting

Authorizations:

Responses

200

all share links

get /_api/v3/security-setting/all-share-links
https://demo.growi.org/_api/v3/_api/v3/security-setting/all-share-links

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "securityParams": { }
}

Delete All ShareLinks at Share Link Setting

Delete All ShareLinks at Share Link Setting

Authorizations:

Responses

200

succeed to delete all share links

delete /_api/v3/security-setting/all-share-links
https://demo.growi.org/_api/v3/_api/v3/security-setting/all-share-links

Update LocalSetting

Update LocalSetting

Authorizations:
Request Body schema: application/json
isLocalEnabled
boolean

local setting mode

registrationMode
string

type of registrationMode

registrationWhitelist
Array of strings

array of regsitrationList

Responses

200

Succeeded to update local Setting

put /_api/v3/security-setting/local-setting
https://demo.growi.org/_api/v3/_api/v3/security-setting/local-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isLocalEnabled": true,
  • "registrationMode": "string",
  • "registrationWhitelist":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isLocalEnabled": true,
  • "registrationMode": "string",
  • "registrationWhitelist":
    [
    ]
}

Update LDAP setting

Update LDAP setting

Authorizations:
Request Body schema: application/json
serverUrl
string

server url for ldap

isUserBind
boolean

enable user bind

ldapBindDN
string

the query used to bind with the directory service

ldapBindDNPassword
string

the password that is entered in the login page will be used to bind

ldapSearchFilter
string

the query used to locate the authenticated user

ldapAttrMapUsername
string

specification of mappings for username when creating new users

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the user name matched

ldapAttrMapMail
string

specification of mappings for mail address when creating new users

ldapAttrMapName
string

Specification of mappings for full name address when creating new users

ldapGroupSearchBase
string

the base DN from which to search for groups.

ldapGroupSearchFilter
string

the query used to filter for groups

ldapGroupDnProperty
string

The property of user object to use in dn interpolation of Group Search Filter

Responses

200

Succeeded to update LDAP setting

put /_api/v3/security-setting/ldap
https://demo.growi.org/_api/v3/_api/v3/security-setting/ldap

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverUrl": "string",
  • "isUserBind": true,
  • "ldapBindDN": "string",
  • "ldapBindDNPassword": "string",
  • "ldapSearchFilter": "string",
  • "ldapAttrMapUsername": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "ldapAttrMapMail": "string",
  • "ldapAttrMapName": "string",
  • "ldapGroupSearchBase": "string",
  • "ldapGroupSearchFilter": "string",
  • "ldapGroupDnProperty": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverUrl": "string",
  • "isUserBind": true,
  • "ldapBindDN": "string",
  • "ldapBindDNPassword": "string",
  • "ldapSearchFilter": "string",
  • "ldapAttrMapUsername": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "ldapAttrMapMail": "string",
  • "ldapAttrMapName": "string",
  • "ldapGroupSearchBase": "string",
  • "ldapGroupSearchFilter": "string",
  • "ldapGroupDnProperty": "string"
}

Update SAML setting

Update SAML setting

Authorizations:
Request Body schema: application/json
samlEntryPoint
string

entry point for saml

samlIssuer
string

issuer for saml

samlCert
string

certificate for saml

samlAttrMapId
string

attribute mapping id for saml

samlAttrMapUserName
string

attribute mapping user name for saml

samlAttrMapMail
string

attribute mapping mail for saml

samlAttrMapFirstName
string

attribute mapping first name for saml

samlAttrMapLastName
string

attribute mapping last name for saml

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the user name matched

isSameEmailTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

samlABLCRule
string

ABLCRule for saml

Responses

200

Succeeded to update SAML setting

put /_api/v3/security-setting/saml
https://demo.growi.org/_api/v3/_api/v3/security-setting/saml

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "samlEntryPoint": "string",
  • "samlIssuer": "string",
  • "samlCert": "string",
  • "samlAttrMapId": "string",
  • "samlAttrMapUserName": "string",
  • "samlAttrMapMail": "string",
  • "samlAttrMapFirstName": "string",
  • "samlAttrMapLastName": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true,
  • "samlABLCRule": "string"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "samlEntryPoint": "string",
  • "samlIssuer": "string",
  • "samlCert": "string",
  • "samlAttrMapId": "string",
  • "samlAttrMapUserName": "string",
  • "samlAttrMapMail": "string",
  • "samlAttrMapFirstName": "string",
  • "samlAttrMapLastName": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true,
  • "samlABLCRule": "string"
}

Update OpenID Connect setting

Update OpenID Connect setting

Authorizations:
Request Body schema: application/json
oidcProviderName
string

provider name for oidc

oidcIssuerHost
string

issuer host for oidc

oidcAuthorizationEndpoint
string

authorization endpoint for oidc

oidcTokenEndpoint
string

token endpoint for oidc

oidcRevocationEndpoint
string

revocation endpoint for oidc

oidcIntrospectionEndpoint
string

introspection endpoint for oidc

oidcUserInfoEndpoint
string

userinfo endpoint for oidc

oidcEndSessionEndpoint
string

end session endpoint for oidc

oidcRegistrationEndpoint
string

registration endpoint for oidc

oidcJWKSUri
string

JSON Web Key Set URI for oidc

oidcClientId
string

client id for oidc

oidcClientSecret
string

client secret for oidc

oidcAttrMapId
string

attr map id for oidc

oidcAttrMapUserName
string

attr map username for oidc

oidcAttrMapName
string

attr map name for oidc

oidcAttrMapMail
string

attr map mail for oidc

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the user name matched

isSameEmailTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

Responses

200

Succeeded to update OpenID Connect setting

put /_api/v3/security-setting/oidc
https://demo.growi.org/_api/v3/_api/v3/security-setting/oidc

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oidcProviderName": "string",
  • "oidcIssuerHost": "string",
  • "oidcAuthorizationEndpoint": "string",
  • "oidcTokenEndpoint": "string",
  • "oidcRevocationEndpoint": "string",
  • "oidcIntrospectionEndpoint": "string",
  • "oidcUserInfoEndpoint": "string",
  • "oidcEndSessionEndpoint": "string",
  • "oidcRegistrationEndpoint": "string",
  • "oidcJWKSUri": "string",
  • "oidcClientId": "string",
  • "oidcClientSecret": "string",
  • "oidcAttrMapId": "string",
  • "oidcAttrMapUserName": "string",
  • "oidcAttrMapName": "string",
  • "oidcAttrMapMail": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "oidcProviderName": "string",
  • "oidcIssuerHost": "string",
  • "oidcAuthorizationEndpoint": "string",
  • "oidcTokenEndpoint": "string",
  • "oidcRevocationEndpoint": "string",
  • "oidcIntrospectionEndpoint": "string",
  • "oidcUserInfoEndpoint": "string",
  • "oidcEndSessionEndpoint": "string",
  • "oidcRegistrationEndpoint": "string",
  • "oidcJWKSUri": "string",
  • "oidcClientId": "string",
  • "oidcClientSecret": "string",
  • "oidcAttrMapId": "string",
  • "oidcAttrMapUserName": "string",
  • "oidcAttrMapName": "string",
  • "oidcAttrMapMail": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true,
  • "isSameEmailTreatedAsIdenticalUser": true
}

Update google OAuth

Update google OAuth

Authorizations:
Request Body schema: application/json
googleClientId
string

key of comsumer

googleClientSecret
string

password of comsumer

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

Responses

200

Succeeded to google OAuth

put /_api/v3/security-setting/google-oauth
https://demo.growi.org/_api/v3/_api/v3/security-setting/google-oauth

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "googleClientId": "string",
  • "googleClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "googleClientId": "string",
  • "googleClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

Update github OAuth

Update github OAuth

Authorizations:
Request Body schema: application/json
githubClientId
string

key of comsumer

githubClientSecret
string

password of comsumer

isSameUsernameTreatedAsIdenticalUser
boolean

local account automatically linked the email matched

Responses

200

Succeeded to github OAuth

put /_api/v3/security-setting/github-oauth
https://demo.growi.org/_api/v3/_api/v3/security-setting/github-oauth

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "githubClientId": "string",
  • "githubClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "githubClientId": "string",
  • "githubClientSecret": "string",
  • "isSameUsernameTreatedAsIdenticalUser": true
}

ShareLinkSettings

Get All ShareLinks at Share Link Setting

Get All ShareLinks at Share Link Setting

Authorizations:

Responses

200

all share links

get /_api/v3/security-setting/all-share-links
https://demo.growi.org/_api/v3/_api/v3/security-setting/all-share-links

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "securityParams": { }
}

Delete All ShareLinks at Share Link Setting

Delete All ShareLinks at Share Link Setting

Authorizations:

Responses

200

succeed to delete all share links

delete /_api/v3/security-setting/all-share-links
https://demo.growi.org/_api/v3/_api/v3/security-setting/all-share-links

LocalSetting

Update LocalSetting

Update LocalSetting

Authorizations:
Request Body schema: application/json
isLocalEnabled
boolean

local setting mode

registrationMode
string

type of registrationMode

registrationWhitelist
Array of strings

array of regsitrationList

Responses

200

Succeeded to update local Setting

put /_api/v3/security-setting/local-setting
https://demo.growi.org/_api/v3/_api/v3/security-setting/local-setting

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isLocalEnabled": true,
  • "registrationMode": "string",
  • "registrationWhitelist":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isLocalEnabled": true,
  • "registrationMode": "string",
  • "registrationWhitelist":
    [
    ]
}

/share-links/

delete all share links related one page

Authorizations:
query Parameters
relatedPage
required
string

page id of share link

Responses

200

Succeeded to delete o all share links related one page

delete /share-links/
https://demo.growi.org/_api/v3/share-links/

delete all share links

delete all share links

Authorizations:

Responses

200

Succeeded to remove all share links

delete /share-links/all
https://demo.growi.org/_api/v3/share-links/all

delete one share link related one page

delete one share link related one page

Authorizations:
path Parameters
id
required
string

id of share link

Responses

200

Succeeded to delete one share link

delete /share-links/{id}
https://demo.growi.org/_api/v3/share-links/{id}

SlackBotSettingParams

get /slack-integration

Get current settings and connection statuses.

Authorizations:

Responses

200

Succeeded to get info.

get /slack-integration-settings/
https://demo.growi.org/_api/v3/slack-integration-settings/

botType

/slack-integration/bot-type

Put botType setting.

Authorizations:
Request Body schema: application/json
currentBotType
string

Responses

200

Succeeded to put botType setting.

put /slack-integration-settings/bot-type/
https://demo.growi.org/_api/v3/slack-integration-settings/bot-type/

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentBotType": "string"
}

/slack-integration/bot-type

Delete botType setting.

Authorizations:
Request Body schema: application/json
currentBotType
string

Responses

200

Succeeded to delete botType setting.

delete /slack-integration/bot-type/
https://demo.growi.org/_api/v3/slack-integration/bot-type/

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "currentBotType": "string"
}

Test relation

Delete botType setting.

Authorizations:

Responses

200

Succeeded to delete botType setting.

post /slack-integration-settings/slack-app-integrations/:id/relation-test
https://demo.growi.org/_api/v3/slack-integration-settings/slack-app-integrations/:id/relation-test

test the connection

Test the connection with slack work space.

Authorizations:
Request Body schema: application/json
testChannel
string

Responses

200

Succeeded to connect to slack work space.

post /slack-integration-settings/without-proxy/test
https://demo.growi.org/_api/v3/slack-integration-settings/without-proxy/test

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "testChannel": "string"
}

UpdateWithoutProxySettings

update customBotWithoutProxy settings

Update customBotWithoutProxy setting.

Authorizations:

Responses

200

Succeeded to put CustomBotWithoutProxy setting.

put /slack-integration-settings/without-proxy/update-settings/
https://demo.growi.org/_api/v3/slack-integration-settings/without-proxy/update-settings/

UpdateWithoutProxyPermissions

update customBotWithoutProxy permissions

Update customBotWithoutProxy permissions.

Authorizations:

Responses

200

Succeeded to put CustomBotWithoutProxy permissions.

put /slack-integration-settings/without-proxy/update-permissions/
https://demo.growi.org/_api/v3/slack-integration-settings/without-proxy/update-permissions/

SlackIntegration

/slack-integration

Generate SlackAppIntegrations

Authorizations:

Responses

200

Succeeded to create slack app integration

post /slack-integration-settings/slack-app-integrations
https://demo.growi.org/_api/v3/slack-integration-settings/slack-app-integrations

delete accessTokens

Delete accessTokens

Authorizations:

Responses

200

Succeeded to delete access tokens for slack

delete /slack-integration-settings/slack-app-integrations/:id
https://demo.growi.org/_api/v3/slack-integration-settings/slack-app-integrations/:id

/slack-integration

Make SlackAppTokens primary

Authorizations:

Responses

200

Succeeded to make it primary

put /slack-integration-settings/slack-app-integrations/:id/makeprimary
https://demo.growi.org/_api/v3/slack-integration-settings/slack-app-integrations/:id/makeprimary

/slack-integration

Regenerate SlackAppTokens

Authorizations:

Responses

200

Succeeded to regenerate slack app tokens

put /slack-integration-settings/slack-app-integrations/:id/regenerate-tokens
https://demo.growi.org/_api/v3/slack-integration-settings/slack-app-integrations/:id/regenerate-tokens

/slack-integration-settings/:id/permissions

update supported commands

Authorizations:

Responses

200

Succeeded to update supported commands

put /slack-integration-settings/slack-app-integrations/:id/permissions
https://demo.growi.org/_api/v3/slack-integration-settings/slack-app-integrations/:id/permissions

Tags

/tags.search

Search tags

Authorizations:
query Parameters
q
string
Example: q=daily

keyword to search

Responses

200

Succeeded to tag list.

403

Forbidden

500

Internal Server Error

get /tags.search
https://demo.growi.org/_api/v3/tags.search

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "tags":
    [
    ]
}

/tags.update

Update tag

Authorizations:
Request Body schema: application/json
pageId
string

page ID

revisionId
string

revision ID

tags
Array of strings (Tags)

Tags

Responses

200

Succeeded to update tag.

403

Forbidden

500

Internal Server Error

post /tags.update
https://demo.growi.org/_api/v3/tags.update

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pageId": "5e07345972560e001761fa63",
  • "revisionId": "5e0734e472560e001761fa68",
  • "tags":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "tags":
    [
    ]
}

/tags.list

Get tags

Authorizations:
query Parameters
limit
integer
Example: limit=10

Limit that was used

offset
integer
Example: offset=20

Only if specified or default page/offset values were used

Responses

200

Succeeded to tag list.

403

Forbidden

500

Internal Server Error

get /tags.list
https://demo.growi.org/_api/v3/tags.list

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ok": true,
  • "data":
    [
    ]
}