{"openapi":"3.0.1","info":{"title":"PostMD API","description":"Markdown documents published as web pages.\n\nUploading needs no credential. Everything else — reading a member's documents, changing them, groups — needs an API key issued from the web app and sent as `Authorization: Bearer pmk_...`.\n\nA document code forms two addresses: `/d/{docCode}` is the viewer a person opens, `/share/{docCode}` is the address to hand out because it carries the title in link previews.","version":"v1"},"servers":[{"url":"https://postmd.turink.com","description":"Generated server url"}],"paths":{"/api/v1/invites/{inviteCode}/join":{"post":{"tags":["group-invite-controller"],"operationId":"join","parameters":[{"name":"inviteCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseGroupItem"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups":{"get":{"tags":["group-controller"],"description":"Requires API key scope `groups:read`.","operationId":"list","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListGroupItem"}}}}},"security":[{"apiKey":[]}]},"post":{"tags":["group-controller"],"description":"Requires API key scope `groups:write`.","operationId":"create","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseGroupItem"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/update":{"post":{"tags":["group-controller"],"description":"Requires API key scope `groups:write`.","operationId":"update","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseGroupItem"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/members/{memberId}/remove":{"post":{"tags":["group-controller"],"operationId":"removeMember","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/leave":{"post":{"tags":["group-controller"],"operationId":"leave","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/invite":{"get":{"tags":["group-controller"],"operationId":"invite","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseInviteLink"}}}}},"security":[{"apiKey":[]}]},"post":{"tags":["group-controller"],"operationId":"setInvite","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"enabled","in":"query","required":true,"schema":{"type":"boolean"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseInviteLink"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/folders":{"get":{"tags":["group-controller"],"description":"Requires API key scope `groups:read`.","operationId":"folders","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListFolderItem"}}}}},"security":[{"apiKey":[]}]},"post":{"tags":["group-controller"],"description":"Requires API key scope `groups:write`.","operationId":"createFolder","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseFolderItem"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/folders/{folderId}/update":{"post":{"tags":["group-controller"],"description":"Requires API key scope `groups:write`.","operationId":"updateFolder","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseFolderItem"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/folders/{folderId}/delete":{"post":{"tags":["group-controller"],"description":"Requires API key scope `groups:write`.","operationId":"deleteFolder","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"folderId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/delete":{"post":{"tags":["group-controller"],"description":"Requires API key scope `groups:write`.","operationId":"delete","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents":{"post":{"tags":["document-controller"],"operationId":"upload","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"array","items":{"type":"string","format":"binary"}},"title":{"type":"string"},"password":{"type":"string"},"shareEndDate":{"type":"string"},"viewerStyle":{"type":"string"},"groupId":{"type":"integer","format":"int64"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDocumentCode"}}}}}}},"/api/v1/documents/{docCode}/update":{"post":{"tags":["document-controller"],"description":"Requires API key scope `documents:write`.","operationId":"update_1","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"},"title":{"type":"string"},"password":{"type":"string"},"clearPassword":{"type":"boolean","default":false},"shareEndDate":{"type":"string"},"clearShareEndDate":{"type":"boolean","default":false},"viewerStyle":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDocumentCode"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}/notes":{"get":{"tags":["document-note-controller"],"description":"Requires API key scope `documents:read`.","operationId":"list_1","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Document-Password","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListNoteView"}}}}},"security":[{"apiKey":[]}]},"post":{"tags":["document-note-controller"],"description":"Requires API key scope `documents:write`.","operationId":"create_1","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Document-Password","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteWrite"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseNoteView"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}/notes/{noteId}/update":{"post":{"tags":["document-note-controller"],"description":"Requires API key scope `documents:write`.","operationId":"update_2","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"noteId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteWrite"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseNoteView"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}/notes/{noteId}/resolve":{"post":{"tags":["document-note-controller"],"description":"Requires API key scope `documents:write`.","operationId":"resolve","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"noteId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NoteResolve"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseNoteView"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}/notes/{noteId}/delete":{"post":{"tags":["document-note-controller"],"description":"Requires API key scope `documents:write`.","operationId":"delete_1","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"noteId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}/group":{"post":{"tags":["document-controller"],"description":"Requires API key scope `documents:write`.","operationId":"moveToGroup","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupAssignRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}/delete":{"post":{"tags":["document-controller"],"description":"Requires API key scope `documents:write`.","operationId":"delete_2","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/uploads":{"post":{"tags":["document-controller"],"description":"Requires API key scope `documents:write`.","operationId":"uploadAttachment","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseUploadedFile"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/bulk":{"post":{"tags":["document-controller"],"description":"Requires API key scope `documents:write`.","operationId":"uploadBulk","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["files"],"type":"object","properties":{"files":{"type":"array","items":{"type":"string","format":"binary"}},"password":{"type":"string"},"shareEndDate":{"type":"string"},"viewerStyle":{"type":"string"},"groupId":{"type":"integer","format":"int64"}}}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseBulkUploadResult"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/auth/withdraw":{"post":{"tags":["auth-controller"],"operationId":"withdraw","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WithdrawRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/auth/register":{"post":{"tags":["auth-controller"],"operationId":"register","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseMemberSummary"}}}}}}},"/api/v1/auth/refresh":{"post":{"tags":["auth-controller"],"operationId":"refresh","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseTokenResponse"}}}}}}},"/api/v1/auth/me/password":{"post":{"tags":["auth-controller"],"operationId":"changePassword","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangePasswordRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/auth/me/language":{"post":{"tags":["auth-controller"],"operationId":"updateLanguage","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguageRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseMemberSummary"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/auth/logout":{"post":{"tags":["auth-controller"],"operationId":"logout","parameters":[{"name":"allDevices","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/auth/login":{"post":{"tags":["auth-controller"],"operationId":"login","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseLoginResponse"}}}}}}},"/api/v1/account/note-colors":{"get":{"tags":["account-note-color-controller"],"operationId":"get","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseColorLabels"}}}}},"security":[{"apiKey":[]}]},"post":{"tags":["account-note-color-controller"],"operationId":"save","requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseColorLabels"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/account/note-colors/reset":{"post":{"tags":["account-note-color-controller"],"operationId":"reset","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseColorLabels"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/account/api-keys":{"get":{"tags":["account-api-key-controller"],"operationId":"list_2","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListKeyItem"}}}}},"security":[{"apiKey":[]}]},"post":{"tags":["account-api-key-controller"],"operationId":"create_2","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseCreatedKey"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/account/api-keys/{id}/revoke":{"post":{"tags":["account-api-key-controller"],"operationId":"revoke","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseVoid"}}}}},"security":[{"apiKey":[]}]}},"/share/{docCode}":{"get":{"tags":["share-meta-controller"],"operationId":"preview","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/html;charset=UTF-8":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"tags":["public-docs-controller"],"operationId":"llmsTxt","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/docs":{"get":{"tags":["public-docs-controller"],"operationId":"index","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/docs/{slug}":{"get":{"tags":["public-docs-controller"],"operationId":"doc","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/api/v1/notes":{"get":{"tags":["my-note-controller"],"description":"Requires API key scope `documents:read`.","operationId":"mine","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListNoteWithDocument"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/invites/{inviteCode}":{"get":{"tags":["group-invite-controller"],"operationId":"preview_1","parameters":[{"name":"inviteCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseInvitePreview"}}}}}}},"/api/v1/groups/{groupId}/members":{"get":{"tags":["group-controller"],"operationId":"members","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListMemberItem"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/groups/{groupId}/documents":{"get":{"tags":["group-controller"],"description":"Requires API key scope `groups:read`, `documents:read`.","operationId":"documents","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"folderId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"rootOnly","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListGroupDocument"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/documents/{docCode}":{"get":{"tags":["document-controller"],"operationId":"view","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Document-Password","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDocumentView"}}}}}}},"/api/v1/documents/{docCode}/raw":{"get":{"tags":["document-controller"],"operationId":"raw","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-Document-Password","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/markdown;charset=UTF-8":{"schema":{"type":"string"}}}}}}},"/api/v1/documents/{docCode}/meta":{"get":{"tags":["document-controller"],"operationId":"meta","parameters":[{"name":"docCode","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseDocumentMeta"}}}}}}},"/api/v1/auth/me":{"get":{"tags":["auth-controller"],"operationId":"me","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseMemberSummary"}}}}},"security":[{"apiKey":[]}]}},"/api/v1/account/api-key-scopes":{"get":{"tags":["account-api-key-controller"],"operationId":"scopeOptions","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ApiResponseListScopeOption"}}}}},"security":[{"apiKey":[]}]}}},"components":{"schemas":{"ApiResponseGroupItem":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/GroupItem"}}},"GroupItem":{"type":"object","properties":{"groupId":{"type":"integer","format":"int64"},"name":{"type":"string"},"groupCode":{"type":"string"},"owner":{"type":"boolean"},"isDefault":{"type":"boolean"},"expireDate":{"type":"string"},"inviteEnabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}}},"Pagination":{"type":"object","properties":{"totalItemCount":{"type":"integer","format":"int64"},"pageItemCount":{"type":"integer","format":"int32"},"pageNo":{"type":"integer","format":"int32"}}},"CreateRequest":{"required":["name"],"type":"object","properties":{"name":{"maxLength":100,"minLength":0,"type":"string"},"expireDate":{"type":"string"}}},"UpdateRequest":{"type":"object","properties":{"name":{"maxLength":100,"minLength":0,"type":"string"},"expireDate":{"type":"string"},"clearExpireDate":{"type":"boolean"}}},"ApiResponseVoid":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"object"}}},"ApiResponseInviteLink":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/InviteLink"}}},"InviteLink":{"type":"object","properties":{"enabled":{"type":"boolean"},"inviteCode":{"type":"string"},"url":{"type":"string"},"updatedAt":{"type":"string","format":"date-time"}}},"FolderRequest":{"required":["name"],"type":"object","properties":{"name":{"maxLength":200,"minLength":0,"type":"string"},"parentFolderId":{"type":"integer","format":"int64"}}},"ApiResponseFolderItem":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/FolderItem"}}},"FolderItem":{"type":"object","properties":{"folderId":{"type":"integer","format":"int64"},"parentFolderId":{"type":"integer","format":"int64"},"name":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}},"ApiResponseDocumentCode":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/DocumentCode"}}},"DocumentCode":{"type":"object","properties":{"docCode":{"type":"string"},"shareUrl":{"type":"string"},"viewerUrl":{"type":"string"}}},"NoteWrite":{"type":"object","properties":{"content":{"maxLength":4000,"minLength":0,"type":"string"},"quotedContent":{"maxLength":4000,"minLength":0,"type":"string"},"scope":{"type":"string"},"color":{"type":"string"},"textStart":{"type":"integer","format":"int32"}}},"ApiResponseNoteView":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/NoteView"}}},"NoteView":{"type":"object","properties":{"noteId":{"type":"integer","format":"int64"},"content":{"type":"string"},"quotedContent":{"type":"string"},"scope":{"type":"string"},"color":{"type":"string"},"textStart":{"type":"integer","format":"int32"},"mine":{"type":"boolean"},"manageable":{"type":"boolean"},"authorName":{"type":"string"},"resolvedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NoteResolve":{"type":"object","properties":{"resolved":{"type":"boolean"}}},"GroupAssignRequest":{"type":"object","properties":{"groupId":{"type":"integer","format":"int64"},"folderId":{"type":"integer","format":"int64"}}},"ApiResponseUploadedFile":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/UploadedFile"}}},"UploadedFile":{"type":"object","properties":{"url":{"type":"string"},"fileName":{"type":"string"},"size":{"type":"integer","format":"int64"}}},"ApiResponseBulkUploadResult":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/BulkUploadResult"}}},"BulkItemResult":{"type":"object","properties":{"fileName":{"type":"string"},"success":{"type":"boolean"},"docCode":{"type":"string"},"resultCode":{"type":"string"},"message":{"type":"string"}}},"BulkUploadResult":{"type":"object","properties":{"total":{"type":"integer","format":"int32"},"succeeded":{"type":"integer","format":"int32"},"results":{"type":"array","items":{"$ref":"#/components/schemas/BulkItemResult"}}}},"WithdrawRequest":{"required":["password"],"type":"object","properties":{"password":{"type":"string"}}},"RegisterRequest":{"required":["email","name","password"],"type":"object","properties":{"email":{"type":"string"},"password":{"maxLength":100,"minLength":8,"type":"string"},"name":{"maxLength":100,"minLength":0,"type":"string"},"language":{"type":"string"}}},"ApiResponseMemberSummary":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/MemberSummary"}}},"MemberSummary":{"type":"object","properties":{"memberId":{"type":"integer","format":"int64"},"email":{"type":"string"},"name":{"type":"string"},"preferredLanguage":{"type":"string"}}},"ApiResponseTokenResponse":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/TokenResponse"}}},"TokenResponse":{"type":"object","properties":{"accessToken":{"type":"string"},"accessTokenExpiresIn":{"type":"integer","format":"int64"}}},"ChangePasswordRequest":{"required":["currentPassword","newPassword"],"type":"object","properties":{"currentPassword":{"type":"string"},"newPassword":{"maxLength":100,"minLength":8,"type":"string"}}},"LanguageRequest":{"required":["language"],"type":"object","properties":{"language":{"type":"string"}}},"LoginRequest":{"required":["email","password"],"type":"object","properties":{"email":{"type":"string"},"password":{"type":"string"},"trustThisDevice":{"type":"boolean"}}},"ApiResponseLoginResponse":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/LoginResponse"}}},"LoginResponse":{"type":"object","properties":{"accessToken":{"type":"string"},"accessTokenExpiresIn":{"type":"integer","format":"int64"},"member":{"$ref":"#/components/schemas/MemberSummary"}}},"ApiResponseColorLabels":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/ColorLabels"}}},"ColorLabels":{"type":"object","properties":{"colors":{"type":"array","items":{"type":"string"}},"labels":{"type":"object","additionalProperties":{"type":"string"}}}},"ApiResponseCreatedKey":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/CreatedKey"}}},"CreatedKey":{"type":"object","properties":{"apiKey":{"type":"string"},"info":{"$ref":"#/components/schemas/KeyItem"}}},"KeyItem":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"name":{"type":"string"},"description":{"type":"string"},"keyPrefix":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"expireDate":{"type":"string"},"status":{"type":"string","enum":["ACTIVE","EXPIRED","REVOKED"]},"createdAt":{"type":"string","format":"date-time"}}},"ApiResponseListNoteWithDocument":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/NoteWithDocument"}}}},"NoteWithDocument":{"type":"object","properties":{"note":{"$ref":"#/components/schemas/NoteView"},"docCode":{"type":"string"},"documentTitle":{"type":"string"}}},"ApiResponseInvitePreview":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/InvitePreview"}}},"InvitePreview":{"type":"object","properties":{"groupId":{"type":"integer","format":"int64"},"name":{"type":"string"},"alreadyJoined":{"type":"boolean"}}},"ApiResponseListGroupItem":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GroupItem"}}}},"ApiResponseListMemberItem":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/MemberItem"}}}},"MemberItem":{"type":"object","properties":{"memberId":{"type":"integer","format":"int64"},"email":{"type":"string"},"name":{"type":"string"},"joinedAt":{"type":"string","format":"date-time"}}},"ApiResponseListFolderItem":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/FolderItem"}}}},"ApiResponseListGroupDocument":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/GroupDocument"}}}},"GroupDocument":{"type":"object","properties":{"docCode":{"type":"string"},"title":{"type":"string"},"fileName":{"type":"string"},"owner":{"type":"boolean"},"hasPassword":{"type":"boolean"},"shareEndDate":{"type":"string"},"viewerStyle":{"type":"string"},"folderId":{"type":"integer","format":"int64"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ApiResponseDocumentView":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/DocumentView"}}},"DocumentView":{"type":"object","properties":{"docCode":{"type":"string"},"title":{"type":"string"},"fileName":{"type":"string"},"hasPassword":{"type":"boolean"},"shareEndDate":{"type":"string"},"viewerStyle":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"sharedNotesAllowed":{"type":"boolean"},"content":{"type":"string"}}},"ApiResponseListNoteView":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/NoteView"}}}},"ApiResponseDocumentMeta":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"$ref":"#/components/schemas/DocumentMeta"}}},"DocumentMeta":{"type":"object","properties":{"docCode":{"type":"string"},"title":{"type":"string"},"fileName":{"type":"string"},"hasPassword":{"type":"boolean"},"shareEndDate":{"type":"string"},"viewerStyle":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ApiResponseListKeyItem":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/KeyItem"}}}},"ApiResponseListScopeOption":{"type":"object","properties":{"resultCode":{"type":"string"},"message":{"type":"string"},"pagination":{"$ref":"#/components/schemas/Pagination"},"data":{"type":"array","items":{"$ref":"#/components/schemas/ScopeOption"}}}},"ScopeOption":{"type":"object","properties":{"code":{"type":"string"},"description":{"type":"string"}}}},"securitySchemes":{"apiKey":{"type":"http","description":"API key issued from the web app. The value starts with `pmk_` and is shown once at creation.\n\nScopes are independent: `documents:write` does not grant `documents:read`.","scheme":"bearer"}}}}