API docs by Redocly

Movable Type Data API (9.1.0)

Download OpenAPI specification:

Find out more about Movable Type Data API

Assets

Upload a file

Permissions

  • upload
Authorizations:
mtauth
query Parameters
overwrite_once
integer
Enum: 0 1

If specify "1", the API always overwrites an existing file with the uploaded file. This parameter has been available since Movable Type 6.1.2

Request Body schema: multipart/form-data
autoRenameIfExists
integer
Default: 0
Enum: 0 1

If this value is "1" and a file with the same filename exists, the uploaded file is automatically renamed to a random generated name. Default is "0".

autoRenameNonAscii
integer
Enum: 0 1

If this value is "1", the filename is renamed non-ascii filename automatically

file
string <binary>

Actual file data
normalizeOrientation
integer
Default: 1
Enum: 0 1

If this value is "1" and the uploaded file has orientation information in Exif data, this file's orientation is automatically normalized. Default is "1".

path
string

The upload destination. You can specify the path to the under the site path.

site_id
integer

The site ID.

Responses

Response samples

Content type
application/json
{
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "fileExtension": "string",
  • "filePath": "string",
  • "filename": "string",
  • "id": "string",
  • "label": "string",
  • "meta": {
    },
  • "mimeType": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "tags": [
    ],
  • "type": "string",
  • "updatable": true,
  • "url": "string"
}

Retrieve assets in the specified site

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label"

The comma separated field name list to search.

Default: label
limit
integer
Default: 10

Maximum number of assets to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
filterKeys
string
Default: "class"

The comma separated field name list to filter.

Default: class
class
string

The target asset class to retrieve. Supported values are image, audio, video, file and any values added by plugins. If you want to retrieve multiple classes, specify the values separated by commas.

sortBy
string
Default: "created_on"
Enum: "file_name" "created_by" "created_on"

file_name

Sort by the filename of each asset.

created_by

Sort by the ID of user who created each asset.

created_on

(default) Sort by the created time of each asset.

Default: created_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return assets in descending order.

ascend

Return assets in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the asset resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

relatedAssets
integer
Enum: 0 1

If you want to retrieve related assets (e.g. thumbnail, popup html) that generated by original asset, you should specify this parameter as true.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Upload a file Deprecated

This endpoint is marked as deprecated in v2.0.

Upload single file to specific site.

Permissions

  • upload
Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: multipart/form-data
autoRenameIfExists
integer
Enum: 0 1

If this value is "1" and the file with the same filename exists, the uploaded file is automatically renamed to the random generated name. Default is "0".

file
string <binary>

The actual file data
normalizeOrientation
integer
Enum: 0 1

If this value is "1" and the uploaded file has a orientation information in Exif, this file's orientation is automatically normalized. Default is "1".

path
string

The upload destination. You can specify the path to the under the site path.

Responses

Response samples

Content type
application/json
{
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "fileExtension": "string",
  • "filePath": "string",
  • "filename": "string",
  • "id": "string",
  • "label": "string",
  • "meta": {
    },
  • "mimeType": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "tags": [
    ],
  • "type": "string",
  • "updatable": true,
  • "url": "string"
}

Delete an asset

  • Authorization is required.

Permissions

  • Manage Assets

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "fileExtension": "string",
  • "filePath": "string",
  • "filename": "string",
  • "id": "string",
  • "label": "string",
  • "meta": {
    },
  • "mimeType": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "tags": [
    ],
  • "type": "string",
  • "updatable": true,
  • "url": "string"
}

Retrieve single asset by its ID

Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer
query Parameters
fields
string

The field list to retrieve as part of the asset resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "fileExtension": "string",
  • "filePath": "string",
  • "filename": "string",
  • "id": "string",
  • "label": "string",
  • "meta": {
    },
  • "mimeType": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "tags": [
    ],
  • "type": "string",
  • "updatable": true,
  • "url": "string"
}

Update an asset

  • Authorization is required.

Permissions

  • Manage Assets

Notes

  • This method accepts PUT and POST with __method=PUT.
Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (asset_updatable)

Responses

Response samples

Content type
application/json
{
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "fileExtension": "string",
  • "filePath": "string",
  • "filename": "string",
  • "id": "string",
  • "label": "string",
  • "meta": {
    },
  • "mimeType": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "tags": [
    ],
  • "type": "string",
  • "updatable": true,
  • "url": "string"
}

Retrieve a list of entries that related with specific asset

  • Authorization is required to include unpublished entries.

Permissions

  • edit_entry
    • to retrieve unpublished entry
Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of entries to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "authored_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: authored_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return entries in descending order.

ascend

Return entries in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the entry resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of entries to include to result.

excludeIds
string

The comma separated ID list of entries to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container entry's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the entries resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of pages that related with specific asset

  • Authorization is required to include unpublished pages.

Permissions

  • manage_pages
    • to retrieve unpublished page
Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of pages to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "modified_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: modified_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return pages in descending order.

ascend

Return pages in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the page resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of pages to include to result.

excludeIds
string

The comma separated ID list of pages to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container page's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the pages resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the pages resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Get thumbnail of an asset

This endpoint requires one of parameter 'width' or 'height' or 'scale' Also, cannot use these parameters at same time.

Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer
query Parameters
width
integer

The width of the thumbnail to generate. If this is the only parameter specified then the thumbnail's width will be scaled proportionally to the height. When a value longer than the original image is specified, it will be ignored.

height
integer

The height of the thumbnail to generate. If this is the only parameter specified then the thumbnail's height will be scaled proportionally to the width. When both of height and width are specified, the longer side of the original image will be processed, and the lesser side will be scaled proportionally.

scale
string

The percentage by which to reduce or increase the size of the current asset.

square
integer
Enum: 0 1

If set to "1" then the thumbnail generated will be square, where the length of each side of the square will be equal to the shortest side of the image.

Responses

Response samples

Content type
application/json
{
  • "height": 0,
  • "url": "string",
  • "width": 0
}

Retrieve assets that related with specified entry

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
limit
integer
Default: 10

Maximum number of assets to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
class
string

The target asset class to retrieve. Supported values are image, audio, video, file and any values added by plugins. If you want to retrieve multiple classes, specify the values separated by commas.

sortBy
string
Default: "created_on"
Enum: "file_name" "created_by" "created_on"

file_name

Sort by the filename of each asset.

created_by

Sort by the ID of user who created each asset.

created_on

(default) Sort by the created time of each asset.

Default: created_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return assets in descending order.

ascend

Return assets in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the asset resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

filterKeys
string
Default: "class"

The comma separated field name list to filter.

Default: class
searchFields
string
Default: "label"

The comma separated field name list to search.

Default: label
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve assets that related with specified page

Authorizations:
mtauth
path Parameters
site_id
required
integer
page_id
required
integer
query Parameters
limit
integer
Default: 10

Maximum number of assets to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
filterKeys
string
Default: "class"

The comma separated field name list to filter.

Default: class
searchFields
string
Default: "label"

The comma separated field name list to search.

Default: label
class
string

The target asset class to retrieve. Supported values are image, audio, video, file and any values added by plugins. If you want to retrieve multiple classes, specify the values separated by commas.

sortBy
string
Default: "created_on"
Enum: "file_name" "created_by" "created_on"

file_name

Sort by the filename of each asset.

created_by

Sort by the ID of user who created each asset.

created_on

(default) Sort by the created time of each asset.

Default: created_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return assets in descending order.

ascend

Return assets in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the asset resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve assets that related with specified tag

Authorizations:
mtauth
path Parameters
site_id
required
integer
tag_id
required
integer
query Parameters
limit
integer
Default: 10

Maximum number of assets to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
filterKeys
string
Default: "class"

The comma separated field name list to filter.

Default: class
searchFields
string
Default: "label"

The comma separated field name list to search.

Default: label
class
string

The target asset class to retrieve. Supported values are image, audio, video, file and any values added by plugins. If you want to retrieve multiple classes, specify the values separated by commas.

sortBy
string
Default: "created_on"
Enum: "file_name" "created_by" "created_on"

file_name

Sort by the filename of each asset.

created_by

Sort by the ID of user who created each asset.

created_on

(default) Sort by the created time of each asset.

Default: created_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return assets in descending order.

ascend

Return assets in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the asset resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Authentication

Invalidate current access token. This is not logout

Invalidate current session. This is like logout. All access tokens related to that session are invalidated too.

Authorization is required. but if there is an effective session, user can revoke by the following methods.

In the case of a web browser, can be authorized by httponly-cookie.

In the case of other than a browser, can be authorized by sending a sessionId that is retrieved via authentication endpoints in MTAuth request header.

MTAuth sessionId={retrieved sessionId}

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
header Parameters
X-MT-Authorization
string

Input MTAuth sessionId={sessionId}

Request Body schema: application/x-www-form-urlencoded
clientId
string

This is not required if you specify session id via "X-MT-Authorization" request header. You can create new access token if you have a session id related to this clientId, although you do not have an access token.

Responses

Response samples

Content type
application/json
{
  • "status": "string"
}

User authentication by username and password

Create a new session and access token. This is like sign-in.

Authorizations:
mtauth
Request Body schema: application/x-www-form-urlencoded
clientId
string

This is not required if you specify session id via "X-MT-Authorization" request header. You can create new access token if you have a session id related to this clientId, although you do not have an access token.

mtDataApiLoginMagicToken
string

This is not required if you authenticate except via browser. If this parameter is passed and valid the MT will set cookie in order to start a session.

password
string <password>

Your Web Service Password
remember
integer
Enum: 0 1

If true (generally, "1" is specified.), a new session will be created as a persistent session. If you want to specify false, you can pass "" or "0" to this parameter.

username
string

Your Sign-in Name

Responses

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "expiresIn": 0,
  • "remember": true,
  • "sessionId": "string"
}

Return authorization(login) form as HTML

Return authorization(login) form as HTML.

Authorizations:
mtauth
query Parameters
redirectUrl
required
string

This is required. When you succeed in login, you are redirected to the redirectUrl with "#_login".

clientId
required
string

This is required. the client ID of the application.

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Invalidate current session. This is like logout

Invalidate current access token. This is not logout. If the browser has active session id, new access token can be obtained easily.

Authorization is required.

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth

Responses

Response samples

Content type
application/json
{
  • "status": "string"
}

Create new access token related to current session

Create new access token related to current session.

In order to create new access token, in the case of a web browser, it is necessary to create session via authentication endpoints beforehand.

In the case of other than a browser, it is necessary to send a sessionId that is retrieved via authentication endpoints in MTAuth request header.

MTAuth sessionId={retrieved sessionId}

Authorizations:
mtauth
header Parameters
X-MT-Authorization
string

Input MTAuth sessionId={sessionId}

Request Body schema: application/x-www-form-urlencoded
clientId
string

This is not required if you specify session id via "X-MT-Authorization" request header. You can create new access token if you have a session id related to this clientId, although you do not have an access token.

Responses

Response samples

Content type
application/json
{
  • "accessToken": "string",
  • "expiresIn": 0
}

BackupRestore

Backup specified site

Authorizations:
mtauth
path Parameters
site_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "backupFiles": [
    ],
  • "status": "string"
}

Categories

Retrieve categories in the specified site

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label,basename"

The comma separated field name list to search.

Default: label,basename
limit
integer
Default: 10

Maximum number of categories to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "user_custom"
Enum: "user_custom" "created_by" "id" "basename" "label"

user_custom

Sort order you specified on the Manage Categories screen.

created_by

Sort by the ID of user who created each category.

id

Sort by the ID of each category.

basename

Sort by the basename of each category.

label

Sort by the label of each category.

Default: user_custom
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return categories in descending order.

ascend

Return categories in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the category resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

top
integer
Default: 0
Enum: 0 1

If set to 1, retrieves only top level categories. New in v2

Default: 0
includeIds
string

The comma separated ID list of categories to include to result.

excludeIds
string

The comma separated ID list of categories to exclude from result.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new category

Authorization is required.

Permission

  • Manage Categories
Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (category_updatable)

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "updatable": true
}

Rearrange existing categories in a new order

  • Authorization is required.
  • This method returns rearranged Categories resource.

Permission

  • Manage Categories
Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: application/x-www-form-urlencoded
categories
string

Array of category resource that were rearranged.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete an existing category

  • Authorization is required.
  • This method returns deleted Category resource.

Permission

  • Manage Categories

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "updatable": true
}

Retrieve single category by its ID

Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
query Parameters
fields
string

The field list to retrieve as part of the category resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "updatable": true
}

Update an existing category

  • Authorization is required.

Permission

  • Manage Categories

Notes

  • This method accepts PUT and POST with __method=PUT.
Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (category_updatable)

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "updatable": true
}

Retrieve child categories from the specified category

Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
query Parameters
maxDepth
integer

The depth of retrieving parent categories.

Default: 0
includeCurrent
integer
Default: 0
Enum: 0 1

1

The list does not include current category.

0

The list includes current category.

Default: 0
header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of entries by specific category

  • Authorization is required to include unpublished entries.

Permissions

  • edit_entry
    • to retrieve unpublished entry
Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of entries to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "authored_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: authored_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return entries in descending order.

ascend

Return entries in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the entry resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of entries to include to result.

excludeIds
string

The comma separated ID list of entries to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container entry's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the entries resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve parent categories from the specified category

Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
query Parameters
maxDepth
integer

The depth of retrieving parent categories.

Default: 0
includeCurrent
integer
Default: 0
Enum: 0 1

1

The list does not include current category.

0

The list includes current category.

Default: 0
header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve siblings categories from the specified category

Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label,basename"

The comma separated field name list to search.

Default: label,basename
limit
integer
Default: 10

Maximum number of categories to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "user_custom"
Enum: "user_custom" "created_by" "id" "basename" "label"

user_custom

Sort order you specified on the Manage Categories screen.

created_by

Sort by the ID of user who created each category.

id

Sort by the ID of each category.

basename

Sort by the basename of each category.

label

Sort by the label of each category.

Default: user_custom
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return categories in descending order.

ascend

Return categories in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the category resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

top
integer
Default: 0
Enum: 0 1

If set to 1, retrieves only top level categories. New in v2

Default: 0
includeIds
string

The comma separated ID list of categories to include to result.

excludeIds
string

The comma separated ID list of categories to exclude from result.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve categories in the specified entry

Permissions

  • edit_entry
    • If you want to retrieve the non-published entry's categories.
Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label,basename"

The comma separated field name list to search.

Default: label,basename
limit
integer
Default: 10

Maximum number of categories to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "user_custom"
Enum: "user_custom" "created_by" "id" "basename" "label"

user_custom

Sort order you specified on the Manage Categories screen.

created_by

Sort by the ID of user who created each category.

id

Sort by the ID of each category.

basename

Sort by the basename of each category.

label

Sort by the label of each category.

Default: user_custom
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return categories in descending order.

ascend

Return categories in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the category resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

top
integer
Default: 0
Enum: 0 1

If set to 1, retrieves only top level categories. New in v2

Default: 0
includeIds
string

The comma separated ID list of categories to include to result.

excludeIds
string

The comma separated ID list of categories to exclude from result.

type
string
Enum: "primary" "secondary"

primary

Retrieve primary category only

secondary

Retrieve secondary categories only
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Comments

Retrieve a list of comments

Retrieve a list of comments.

Authorization is required to include unpublished comments

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
limit
integer

This is an optional parameter. Maximum number of comments to retrieve. Default is 10.

offset
integer

This is an optional parameter. 0-indexed offset. Default is 0.

includeIds
string

This is an optional parameter. The comma separated ID list of comments to include to result.

excludeIds
string

This is an optional parameter. The comma separated ID list of comments to exclude from result.

status
string
Enum: "Approved" "Pending" "Spam"

This is an optional parameter. Filter by status.

Approved

comment_visible is 1 and comment_junk_status is 1.

Pending

comment_visible is 0 and comment_junk_status is 1.

Spam

comment_junk_status is -1.
entryStatus
string
Enum: "Draft" "Publish" "Review" "Future" "Spam"

This is an optional parameter. Filter by parent entry's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.
filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
searchFields
string
Default: "body"

The comma separated field name list to search.

Default: body
sortBy
string
Default: "id"

Default: id
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return comments in descending order.

ascend

Return comments in ascending order.

Default: descend
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Delete a comment

Delete a comment.

Authorization is required.

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
path Parameters
site_id
required
integer
comment_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Retrieve a single comment by its ID

Retrieve a single comment by its ID.

Authorization is required if the comment status is "unpublished". If the comment status is "published", then this method can be called without authorization.

Authorizations:
mtauth
path Parameters
site_id
required
integer
comment_id
required
integer
header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Update a comment

Update a comment.

Authorization is required.

Notes

  • This method accepts PUT and POST with __method=PUT.
Authorizations:
mtauth
path Parameters
site_id
required
integer
comment_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Retrieve a list of comments for an entry

Retrieve a list of comments for an entry.

Authorization is required to include unpublished comments

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
limit
integer

This is an optional parameter. Maximum number of comments to retrieve. Default is 10.

offset
integer

This is an optional parameter. 0-indexed offset. Default is 0.

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
searchFields
string
Default: "body"

The comma separated field name list to search.

Default: body
sortBy
string
Default: "id"

Default: id
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return comments in descending order.

ascend

Return comments in ascending order.

Default: descend
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new comment on an entry

Create a new comment on an entry.

Authorization is required.

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Reply to specified comment

Reply to specified comment.

Authorization is required.

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
comment_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Retrieve a list of comments for the specified page

Retrieve a list of comments for a page.

Authorization is required to include unpublished comments

Authorizations:
mtauth
path Parameters
site_id
required
integer
page_id
required
integer
query Parameters
limit
integer

This is an optional parameter. Maximum number of comments to retrieve. Default is 10.

offset
integer

This is an optional parameter. 0-indexed offset. Default is 0.

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
searchFields
string
Default: "body"

The comma separated field name list to search.

Default: body
sortBy
string
Default: "id"

Default: id
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return comments in descending order.

ascend

Return comments in ascending order.

Default: descend
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new comment on a page

Create a new comment on a page.

Authorization is required.

Authorizations:
mtauth
path Parameters
site_id
required
integer
page_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Reply to specified comment

Reply to specified comment.

Authorization is required.

Authorizations:
mtauth
path Parameters
site_id
required
integer
page_id
required
integer
comment_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Common API

Retrieve OpenAPI schema

Authorizations:
mtauth

Responses

Response samples

Content type
application/json
{ }

Get server API version

Retrieves Data API version of the server.

This endpoint has been available since Movable Type 6.2.4.

This endpoint does not need /v3 or something API endpoint version identifier. You can call like: https://host/path/your-mt-data-api.cgi/version

Authorizations:
mtauth

Responses

Response samples

Content type
application/json
{
  • "apiVersion": 0.1,
  • "endpointVersion": "string"
}

CustomFields

Retrieve a list of fields in the specified site

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "name,basename,description,tag"

The comma separated field name list to search.

Default: name,basename,description,tag

limit
integer
Default: 25

Maximum number of fields to retrieve.

Default: 25
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "name"

Default: name
sortOrder
string
Default: "ascend"
Enum: "descend" "ascend"

descend

Return fields in descending order.

ascend

Return fields in ascending order.

Default: ascend
fields
string

The field list to retrieve as part of the field resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

filterKeys
string
Default: "systemObject,type"

The comma separated field name list to filter.

Default: systemObject,type

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new field

Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (field_updatable)

Responses

Response samples

Content type
application/json
{
  • "basename": "string",
  • "blog": {
    },
  • "default": "string",
  • "description": "string",
  • "id": "string",
  • "name": "string",
  • "options": "string",
  • "required": true,
  • "showInTheseCategories": [
    ],
  • "systemObject": "string",
  • "tag": "string",
  • "type": "string",
  • "updatable": true
}

Delete a field

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
path Parameters
site_id
required
integer
field_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "basename": "string",
  • "blog": {
    },
  • "default": "string",
  • "description": "string",
  • "id": "string",
  • "name": "string",
  • "options": "string",
  • "required": true,
  • "showInTheseCategories": [
    ],
  • "systemObject": "string",
  • "tag": "string",
  • "type": "string",
  • "updatable": true
}

Retrieve single field by its ID

Authorizations:
mtauth
path Parameters
site_id
required
integer
field_id
required
integer
query Parameters
fields
string

The field list to retrieve as part of the field resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

Responses

Response samples

Content type
application/json
{
  • "basename": "string",
  • "blog": {
    },
  • "default": "string",
  • "description": "string",
  • "id": "string",
  • "name": "string",
  • "options": "string",
  • "required": true,
  • "showInTheseCategories": [
    ],
  • "systemObject": "string",
  • "tag": "string",
  • "type": "string",
  • "updatable": true
}

Update a field

Notes

  • This method accepts PUT and POST with __method=PUT.
Authorizations:
mtauth
path Parameters
site_id
required
integer
field_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (field_updatable)

Responses

Response samples

Content type
application/json
{
  • "basename": "string",
  • "blog": {
    },
  • "default": "string",
  • "description": "string",
  • "id": "string",
  • "name": "string",
  • "options": "string",
  • "required": true,
  • "showInTheseCategories": [
    ],
  • "systemObject": "string",
  • "tag": "string",
  • "type": "string",
  • "updatable": true
}

Endpoints

Retrieve a list of endpoints

Retrieve a list of endpoints.

Authorizations:
mtauth
query Parameters
includeComponents
string

This is an optional parameter. The comma separated ID list of components (a.k.a plugin) to include to result.

excludeComponents
string

This is an optional parameter. The comma separated ID list of components (a.k.a plugin) to exclude from result.

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Entries

Rebuild the static archives in relation to specified entries

Rebuild the static archives in relation to specified entries.

Authorization is required.

Authorizations:
mtauth
query Parameters
ids
string

This is an required parameter. The comma separated ID list of entries to rebuild.

blogId
integer

This is an optional parameter.
startTime
string

This is an optional parameter.

Responses

Response samples

Content type
application/json
{
  • "restIds": "string",
  • "startTime": "2019-08-24T14:15:22Z",
  • "status": "Rebuilding"
}

Retrieve a list of entries that related with specific asset

  • Authorization is required to include unpublished entries.

Permissions

  • edit_entry
    • to retrieve unpublished entry
Authorizations:
mtauth
path Parameters
site_id
required
integer
asset_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of entries to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "authored_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: authored_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return entries in descending order.

ascend

Return entries in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the entry resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of entries to include to result.

excludeIds
string

The comma separated ID list of entries to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container entry's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the entries resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of entries by specific category

  • Authorization is required to include unpublished entries.

Permissions

  • edit_entry
    • to retrieve unpublished entry
Authorizations:
mtauth
path Parameters
site_id
required
integer
category_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of entries to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "authored_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: authored_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return entries in descending order.

ascend

Return entries in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the entry resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of entries to include to result.

excludeIds
string

The comma separated ID list of entries to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container entry's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the entries resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of entries

Retrieve a list of entries.

Authorization is required to include unpublished entries.

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
search
string

This is an optional parameter. Search query.

searchFields
string

This is an optional parameter. The comma separated field name list to search. Default is 'title,body,more,keywords,excerpt,basename'

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

This is an optional parameter. Filter by status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
limit
integer

This is an optional parameter. Maximum number of entries to retrieve. Default is 10.

offset
integer

This is an optional parameter. 0-indexed offset. Default is 0.

includeIds
string

This is an optional parameter. The comma separated ID list of entries to include to result.

excludeIds
string

This is an optional parameter. The comma separated ID list of entries to exclude from result.

sortBy
string
Enum: "authored_on" "title" "created_on" "modified_on"

This is an optional parameter.

authored_on

(default) Sort by the Published time of each entries.

title

Sort by the title of each entries.

created_on

Sort by the created time of each entries.

modified_on

Sort by the modified time of each entries.

sortOrder
string
Enum: "descend" "ascend"

This is an optional parameter.

descend

(default) Return entries in descending order. For the date, it means from newest to oldest.

ascend

Return entries in ascending order. For the date, it means from oldest to newset.

maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the Entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the Entries resource. If this parameter is not supplied, no trackbacks will be returned.

fields
string

The field list to retrieve as part of the Entries resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new entry

  • Authorization is required.

Update in v2.0

  • You can attach categories and assets in one request.

Permissions

  • create_post
Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
saveRevision
integer
Enum: 0 1

Save a revision or not
Request Body schema: application/x-www-form-urlencoded
object (entry_updatable)
publish
integer
Enum: 0 1

If this value is "0", the entry is not published

Responses

Response samples

Content type
application/json
{
  • "allowComments": true,
  • "assets": [
    ],
  • "author": {
    },
  • "basename": "string",
  • "blog": {
    },
  • "body": "string",
  • "categories": [
    ],
  • "class": "string",
  • "commentCount": 0,
  • "comments": [
    ],
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "excerpt": "string",
  • "format": "string",
  • "id": 0,
  • "keywords": "string",
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "more": "string",
  • "permalink": "string",
  • "status": "string",
  • "tags": [
    ],
  • "title": "string",
  • "unpublishedDate": "2019-08-24T14:15:22Z",
  • "updatable": true
}

Export entries

Authorizations:
mtauth
path Parameters
site_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

Import entries

Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: multipart/form-data
convert_breaks
string
default_cat_id
integer
default_status
string

If you set import_type is "import_mt_format", also you can set default entry status.

encoding
string
file
string <binary>
import_as_me
integer
Default: 1
Enum: 0 1

0

Preserve original user

1

Import as me

Default: 1
import_type
string
password
string

If you choose import_as_me is 0, you must define a default password for those new accounts.

Responses

Response samples

Content type
application/json
{
  • "message": "string",
  • "status": "string"
}

Make a preview for a entry

  • Authorization is required.
  • This endpoint has been available since Movable Type 6.1.2.

Permissions

  • create_post
Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
raw
integer
Default: 0
Enum: 0 1

If specify "1", will be returned preview contents.

Request Body schema: application/x-www-form-urlencoded
object (entry)

Updatable fields are status, title, body, more, excerpt, keywords, tags, date, basename, customFields, allowComments, format, unpublishedDate

Responses

Response samples

Content type
application/json
{
  • "preview": "string",
  • "status": "string"
}

Delete an entry

Delete an entry.

Authorization is required.

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "allowComments": true,
  • "assets": [
    ],
  • "author": {
    },
  • "basename": "string",
  • "blog": {
    },
  • "body": "string",
  • "categories": [
    ],
  • "class": "string",
  • "commentCount": 0,
  • "comments": [
    ],
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "excerpt": "string",
  • "format": "string",
  • "id": 0,
  • "keywords": "string",
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "more": "string",
  • "permalink": "string",
  • "status": "string",
  • "tags": [
    ],
  • "title": "string",
  • "unpublishedDate": "2019-08-24T14:15:22Z",
  • "updatable": true
}

Retrieve a single entry by its ID

Retrieve a single entry by its ID.

Authorization is required if the entry status is "unpublished". If the entry status is "published", then this method can be called without authorization.

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the Entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the Entries resource. If this parameter is not supplied, no trackbacks will be returned.

fields
string

This is an optional parameter. The field list to retrieve as part of the Entries resource. That list should be separated by commma. If this parameter is not specified, All fields will be returned.

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "allowComments": true,
  • "assets": [
    ],
  • "author": {
    },
  • "basename": "string",
  • "blog": {
    },
  • "body": "string",
  • "categories": [
    ],
  • "class": "string",
  • "commentCount": 0,
  • "comments": [
    ],
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "excerpt": "string",
  • "format": "string",
  • "id": 0,
  • "keywords": "string",
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "more": "string",
  • "permalink": "string",
  • "status": "string",
  • "tags": [
    ],
  • "title": "string",
  • "unpublishedDate": "2019-08-24T14:15:22Z",
  • "updatable": true
}

Update an entry

  • Authorization is required.

Update in v2.0

  • You can attach/detach categories and assets in one request.

Permissions

  • edit_entry
    • to retrieve unpublished entry

Notes

  • This method accepts PUT and POST with __method=PUT.
Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
saveRevision
integer
Enum: 0 1

Save a revision or not
Request Body schema: application/x-www-form-urlencoded
object (entry_updatable)
publish
integer
Enum: 0 1

If this value is "0", the entry is not published

Responses

Response samples

Content type
application/json
{
  • "allowComments": true,
  • "assets": [
    ],
  • "author": {
    },
  • "basename": "string",
  • "blog": {
    },
  • "body": "string",
  • "categories": [
    ],
  • "class": "string",
  • "commentCount": 0,
  • "comments": [
    ],
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "excerpt": "string",
  • "format": "string",
  • "id": 0,
  • "keywords": "string",
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "more": "string",
  • "permalink": "string",
  • "status": "string",
  • "tags": [
    ],
  • "title": "string",
  • "unpublishedDate": "2019-08-24T14:15:22Z",
  • "updatable": true
}

Retrieve assets that related with specified entry

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
limit
integer
Default: 10

Maximum number of assets to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
class
string

The target asset class to retrieve. Supported values are image, audio, video, file and any values added by plugins. If you want to retrieve multiple classes, specify the values separated by commas.

sortBy
string
Default: "created_on"
Enum: "file_name" "created_by" "created_on"

file_name

Sort by the filename of each asset.

created_by

Sort by the ID of user who created each asset.

created_on

(default) Sort by the created time of each asset.

Default: created_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return assets in descending order.

ascend

Return assets in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the asset resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

filterKeys
string
Default: "class"

The comma separated field name list to filter.

Default: class
searchFields
string
Default: "label"

The comma separated field name list to search.

Default: label
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of comments for an entry

Retrieve a list of comments for an entry.

Authorization is required to include unpublished comments

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
limit
integer

This is an optional parameter. Maximum number of comments to retrieve. Default is 10.

offset
integer

This is an optional parameter. 0-indexed offset. Default is 0.

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
searchFields
string
Default: "body"

The comma separated field name list to search.

Default: body
sortBy
string
Default: "id"

Default: id
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return comments in descending order.

ascend

Return comments in ascending order.

Default: descend
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new comment on an entry

Create a new comment on an entry.

Authorization is required.

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Reply to specified comment

Reply to specified comment.

Authorization is required.

Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
comment_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (comment_updatable)

Responses

Response samples

Content type
application/json
{
  • "author": {
    },
  • "blog": {
    },
  • "body": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "date": "2019-08-24T14:15:22Z",
  • "entry": {
    },
  • "id": 0,
  • "link": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": 0,
  • "status": "string",
  • "updatable": true
}

Make a preview for a entry with existing data

  • Authorization is required.
  • This endpoint has been available since Movable Type 6.1.2.
  • entry parameter is required. If you just want to get preview entry from existing data, you should provide entry parameter with empty json.

Permissions

  • create_post
Authorizations:
mtauth
path Parameters
site_id
required
integer
entry_id
required
integer
query Parameters
raw
integer
Default: 0
Enum: 0 1

If specify "1", will be returned preview contents.

Request Body schema: application/x-www-form-urlencoded
object (entry)

Updatable fields are status, title, body, more, excerpt, keywords, tags, date, basename, customFields, allowComments, format, unpublishedDate

Responses

Response samples

Content type
application/json
{
  • "preview": "string",
  • "status": "string"
}

Retrieve a list of entries that related with specific tag

  • Authorization is required to include unpublished entries.

Permissions

  • edit_entry
    • to retrieve unpublished entry
Authorizations:
mtauth
path Parameters
site_id
required
integer
tag_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of entries to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "authored_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: authored_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return entries in descending order.

ascend

Return entries in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the entry resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of entries to include to result.

excludeIds
string

The comma separated ID list of entries to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container entry's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the entries resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the entries resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Folders

Retrieve a list of folders

Authentication required if you want to get private properties.

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label,basename"

The comma separated field name list to search.

Default: label,basename
limit
integer
Default: 10

Maximum number of folders to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "user_custom"
Enum: "user_custom" "created_by" "id" "basename" "label"

user_custom

Sort order you specified on the Manage Folders screen.

created_by

Sort by the ID of creator.

id

Sort by its own ID.

basename

Sort by the basename of each folders.

label

Sort by the label of each folders.

Default: user_custom
sortOrder
string
Default: "ascend"
Enum: "descend" "ascend"

descend

Return folders in descending order.

ascend

Return folders in ascending order.

Default: ascend
fields
string

The field list to retrieve as part of the folder resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of folders to include to result.

excludeIds
string

The comma separated ID list of folders to exclude from result.

top
integer
Default: 0
Enum: 0 1

If set to 1, retrieves only top level folders.

Default: 0
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new folder.

Authorization is required.

Permission

  • Manage Pages
Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (folder_updatable)

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "path": "string",
  • "updatable": true
}

Rearrange existing folders in a new order

  • Authorization is required.
  • This method returns rearranged Folders resource.

Permission

  • Manage Pages
Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: application/x-www-form-urlencoded
folders
string

Array of folder resource that were rearranged.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete an existing folder

  • Authorization is required.
  • This method returns deleted Folder resource.

Permission

  • Manage Pages

Notes

  • This method accepts DELETE and POST with __method=DELETE.
Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "path": "string",
  • "updatable": true
}

Retrieve single folder by its ID

Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer
query Parameters
fields
string

The field list to retrieve as part of the folder resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "path": "string",
  • "updatable": true
}

Update an existing folder

  • Authorization is required.

Permission

  • Manage Pages

Notes

  • This method accepts PUT and POST with __method=PUT.
Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (folder_updatable)

Responses

Response samples

Content type
application/json
{
  • "archiveLink": "string",
  • "basename": "string",
  • "blog": {
    },
  • "class": "string",
  • "createdBy": {
    },
  • "createdDate": "2019-08-24T14:15:22Z",
  • "customFields": [
    ],
  • "description": "string",
  • "id": 0,
  • "label": "string",
  • "modifiedBy": {
    },
  • "modifiedDate": "2019-08-24T14:15:22Z",
  • "parent": "string",
  • "path": "string",
  • "updatable": true
}

Retrieve a list of child folders of the requested folder

Authentication required if you want to get private properties.

Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer
query Parameters
maxDepth
integer

The depth of retrieving child folders.

Default: 0
includeCurrent
integer
Default: 0
Enum: 0 1

1

The results includes current folder.

0

The results do not include current folder.

Default: 0
header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of pages by specific folder

  • Authorization is required to include unpublished pages.

Permissions

  • manage_pages
    • to retrieve unpublished page
Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "title,body,more,keywords,excerpt,basename"

The comma separated field name list to search.

Default: title,body,more,keywords,excerpt,basename

limit
integer
Default: 10

Maximum number of pages to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "modified_on"
Enum: "authored_on" "title" "created_on" "modified_on"

The field name for sort. You can specify one of following values

  • authored_on
  • title
  • created_on
  • modified_on

Default: modified_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return pages in descending order.

ascend

Return pages in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the page resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of pages to include to result.

excludeIds
string

The comma separated ID list of pages to exclude from result.

status
string
Enum: "Draft" "Publish" "Review" "Future" "Spam" "Unpublish"

Filter by container page's status.

Draft

entry_status is 1.

Publish

entry_status is 2.

Review

entry_status is 3.

Future

entry_status is 4.

Spam

entry_status is 5.

Unpublish

entry_status is 6.
maxComments
integer

This is an optional parameter. Maximum number of comments to retrieve as part of the pages resource. If this parameter is not supplied, no comments will be returned.

maxTrackbacks
integer

This is an optional parameter. Maximum number of received trackbacks to retrieve as part of the pages resource. If this parameter is not supplied, no trackbacks will be returned.

no_text_filter
integer
Enum: 0 1

If you want to fetch the raw text, set to '1'. New in v2

filterKeys
string
Default: "status"

The comma separated field name list to filter.

Default: status
dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of parent folders of the requested folder

Authentication required if you want to get private properties.

Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer
query Parameters
maxDepth
integer

The depth of retrieving parent folders.

Default: 0
includeCurrent
integer
Default: 0
Enum: 0 1

1

The results includes current folder.

0

The results do not include current folder.

Default: 0
header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Retrieve a list of sibling folders of the requested folder

Authentication required if you want to get private properties.

Authorizations:
mtauth
path Parameters
site_id
required
integer
folder_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label,basename"

The comma separated field name list to search.

Default: label,basename
limit
integer
Default: 10

Maximum number of folders to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "user_custom"
Enum: "user_custom" "created_by" "id" "basename" "label"

user_custom

Sort order you specified on the Manage Folders screen.

created_by

Sort by the ID of creator.

id

Sort by its own ID.

basename

Sort by the basename of each folders.

label

Sort by the label of each folders.

Default: user_custom
sortOrder
string
Default: "ascend"
Enum: "descend" "ascend"

descend

Return folders in descending order.

ascend

Return folders in ascending order.

Default: ascend
fields
string

The field list to retrieve as part of the folder resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of folders to include to result.

excludeIds
string

The comma separated ID list of folders to exclude from result.

top
integer
Default: 0
Enum: 0 1

Default: 0

If set to 1, retrieves only top level folders.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

header Parameters
X-MT-Authorization
string

Input MTAuth accessToken={accessToken}

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

FormattedText

Retrieve a list of formatted_texts in the specified site

Authorizations:
mtauth
path Parameters
site_id
required
integer
query Parameters
search
string

Search query.
searchFields
string
Default: "label,text,description"

The comma separated field name list to search.

Default: label,text,description

limit
integer
Default: 10

Maximum number of formatted_texts to retrieve.

Default: 10
offset
integer
Default: 0

0-indexed offset.

Default: 0
sortBy
string
Default: "created_on"

Default: created_on
sortOrder
string
Default: "descend"
Enum: "descend" "ascend"

descend

Return formatted_texts in descending order.

ascend

Return formatted_texts in ascending order.

Default: descend
fields
string

The field list to retrieve as part of the formatted_text resource. That list should be separated by comma. If this parameter is not specified, All fields will be returned.

includeIds
string

The comma separated ID list of formatted_texts to include to result.

excludeIds
string

The comma separated ID list of formatted_texts to exclude from result.

dateField
string
Default: "created_on"

Specifies the field name to be used as a date field for filtering. (new in v3)

dateFrom
string

The start date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

dateTo
string

The end date to filtering. Specify in "YYYY-MM-DD" format. (new in v3)

Responses

Response samples

Content type
application/json
{
  • "items": [
    ],
  • "totalResults": 0
}

Create a new formatted_text

Authorizations:
mtauth
path Parameters
site_id
required
integer
Request Body schema: application/x-www-form-urlencoded
object (formatted_text_updatable)

Responses