POSTAPIの概要 実装を見る
No description provided.
Credential required: Yes / Permission: write:pages
パラメータ
名前 | 型 | 既定値 |
---|
必須 | pageId | 文字列 | - |
必須 | title | 文字列 | - |
必須 | name | 文字列 | - |
任意 | summary | 文字列 | - |
必須 | content | 配列(内容: オブジェクト) | - |
必須 | variables | 配列(内容: オブジェクト) | - |
必須 | script | 文字列 | - |
任意 | eyeCatchingImageId | 文字列 | - |
| font | 文字列 | - |
| alignCenter | 真偽値 | - |
| hideTitleWhenPinned | 真偽値 | - |
204 レスポンス リクエスト成功(内容なし)
400 エラー クライアント側エラー
401 エラー 認証エラー
403 エラー 権限関連のエラー
418 エラー I'm Ai
429 エラー レートリミット
500 エラー サーバー内部エラー
{
"_path": "/api-docs/endpoints/pages/update",
"_dir": "pages",
"_draft": false,
"_partial": false,
"_locale": "",
"data": {
"post": {
"operationId": "pages/update",
"summary": "pages/update",
"description": "No description provided.\n\n**Credential required**: *Yes* / **Permission**: *write:pages*",
"externalDocs": {
"description": "Source code",
"url": "https://github.com/misskey-dev/misskey/blob/develop/packages/backend/src/server/api/endpoints/pages/update.ts"
},
"tags": [
"pages"
],
"security": [
{
"ApiKeyAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"pageId": {
"type": "string",
"format": "misskey:id"
},
"title": {
"type": "string"
},
"name": {
"type": "string",
"minLength": 1
},
"summary": {
"type": "string",
"nullable": true
},
"content": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"variables": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"script": {
"type": "string"
},
"eyeCatchingImageId": {
"type": "string",
"format": "misskey:id",
"nullable": true
},
"font": {
"type": "string",
"enum": [
"serif",
"sans-serif"
]
},
"alignCenter": {
"type": "boolean"
},
"hideTitleWhenPinned": {
"type": "boolean"
}
},
"required": [
"pageId",
"title",
"name",
"content",
"variables",
"script"
]
}
}
}
},
"responses": {
"204": {
"description": "OK (without any results)"
},
"400": {
"description": "Client error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"examples": {
"NO_SUCH_PAGE": {
"value": {
"error": {
"message": "No such page.",
"code": "NO_SUCH_PAGE",
"id": "21149b9e-3616-4778-9592-c4ce89f5a864"
}
}
},
"ACCESS_DENIED": {
"value": {
"error": {
"message": "Access denied.",
"code": "ACCESS_DENIED",
"id": "3c15cd52-3b4b-4274-967d-6456fc4f792b"
}
}
},
"NO_SUCH_FILE": {
"value": {
"error": {
"message": "No such file.",
"code": "NO_SUCH_FILE",
"id": "cfc23c7c-3887-490e-af30-0ed576703c82"
}
}
},
"NAME_ALREADY_EXISTS": {
"value": {
"error": {
"message": "Specified name already exists.",
"code": "NAME_ALREADY_EXISTS",
"id": "2298a392-d4a1-44c5-9ebb-ac1aeaa5a9ab"
}
}
},
"INVALID_PARAM": {
"value": {
"error": {
"message": "Invalid param.",
"code": "INVALID_PARAM",
"id": "3d81ceae-475f-4600-b2a8-2bc116157532"
}
}
}
}
}
}
},
"401": {
"description": "Authentication error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"examples": {
"CREDENTIAL_REQUIRED": {
"value": {
"error": {
"message": "Credential required.",
"code": "CREDENTIAL_REQUIRED",
"id": "1384574d-a912-4b81-8601-c7b1c4085df1"
}
}
}
}
}
}
},
"403": {
"description": "Forbidden error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"examples": {
"AUTHENTICATION_FAILED": {
"value": {
"error": {
"message": "Authentication failed. Please ensure your token is correct.",
"code": "AUTHENTICATION_FAILED",
"id": "b0a7f5f8-dc2f-4171-b91f-de88ad238e14"
}
}
}
}
}
}
},
"418": {
"description": "I'm Ai",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"examples": {
"I_AM_AI": {
"value": {
"error": {
"message": "You sent a request to Ai-chan, Misskey's showgirl, instead of the server.",
"code": "I_AM_AI",
"id": "60c46cd1-f23a-46b1-bebe-5d2b73951a84"
}
}
}
}
}
}
},
"429": {
"description": "To many requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"examples": {
"RATE_LIMIT_EXCEEDED": {
"value": {
"error": {
"message": "Rate limit exceeded. Please try again later.",
"code": "RATE_LIMIT_EXCEEDED",
"id": "d5826d14-3982-4d2e-8011-b9e9f02499ef"
}
}
}
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
},
"examples": {
"INTERNAL_ERROR": {
"value": {
"error": {
"message": "Internal error occurred. Please contact us if the error persists.",
"code": "INTERNAL_ERROR",
"id": "5d37dbcb-891e-41ca-a3d6-e690c97775ac"
}
}
}
}
}
}
}
}
}
},
"title": "pages/update",
"_id": "content:api-docs:endpoints:pages:update.json",
"_type": "json",
"_source": "content",
"_file": "api-docs/endpoints/pages/update.json",
"_extension": "json"
}