memos接口文档
memos 简介
memos[1] 是一个开源、自托管的备忘录中心,项目基于 Golang 和 TypeScript 开发。采用的技术栈如下。
| 前端 | 后端 |
| Tailwind CSS | SQLite |
| Vite | |
| pnpm | |
Version: 1.0接口文档
/api/v1/auth/signin
POST
Summary
Sign-in to memos.
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Sign-in object | Yes | github_com_usememos_memos_api_v1.SignIn |
Responses
Code | Description | Schema |
---|---|---|
200 | User information | store.User |
400 | Malformatted signin request | |
401 | Password login is deactivated | Incorrect login credentials, please try again | |
403 | User has been archived with username %s | |
500 | Failed to find system setting | Failed to unmarshal system setting | Incorrect login credentials, please try again | Failed to generate tokens | Failed to create activity |
/api/v1/auth/signin/sso
POST
Summary
Sign-in to memos using SSO.
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | SSO sign-in object | Yes | github_com_usememos_memos_api_v1.SSOSignIn |
Responses
Code | Description | Schema |
---|---|---|
200 | User information | store.User |
400 | Malformatted signin request | |
401 | Access denied, identifier does not match the filter. | |
403 | User has been archived with username {username} | |
404 | Identity provider not found | |
500 | Failed to find identity provider | Failed to create identity provider instance | Failed to exchange token | Failed to get user info | Failed to compile identifier filter | Incorrect login credentials, please try again | Failed to generate random password | Failed to generate password hash | Failed to create user | Failed to generate tokens | Failed to create activity |
/api/v1/auth/signout
POST
Summary
Sign-out from memos.
Responses
Code | Description | Schema |
---|---|---|
200 | Sign-out success | boolean |
/api/v1/auth/signup
POST
Summary
Sign-up to memos.
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Sign-up object | Yes | github_com_usememos_memos_api_v1.SignUp |
Responses
Code | Description | Schema |
---|---|---|
200 | User information | store.User |
400 | Malformatted signup request | Failed to find users | |
401 | signup is disabled | |
403 | Forbidden | |
404 | Not found | |
500 | Failed to find system setting | Failed to unmarshal system setting allow signup | Failed to generate password hash | Failed to create user | Failed to generate tokens | Failed to create activity |
/api/v1/idp
GET
Summary
Get a list of identity providers
Description
*clientSecret is only available for host user
Responses
Code | Description | Schema |
---|---|---|
200 | List of available identity providers | [ github_com_usememos_memos_api_v1.IdentityProvider ] |
500 | Failed to find identity provider list | Failed to find user |
POST
Summary
Create Identity Provider
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Identity provider information | Yes | github_com_usememos_memos_api_v1.CreateIdentityProviderRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Identity provider information | store.IdentityProvider |
400 | Malformatted post identity provider request | |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to create identity provider |
/api/v1/idp/{idpId}
DELETE
Summary
Delete an identity provider by ID
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
idpId | path | Identity Provider ID | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Identity Provider deleted | boolean |
400 | ID is not a number: %s | Malformatted patch identity provider request | |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to patch identity provider |
GET
Summary
Get an identity provider by ID
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
idpId | path | Identity provider ID | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Requested identity provider | store.IdentityProvider |
400 | ID is not a number: %s | |
401 | Missing user in session | Unauthorized | |
404 | Identity provider not found | |
500 | Failed to find identity provider list | Failed to find user |
PATCH
Summary
Update an identity provider by ID
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
idpId | path | Identity Provider ID | Yes | integer |
body | body | Patched identity provider information | Yes | github_com_usememos_memos_api_v1.UpdateIdentityProviderRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Patched identity provider | store.IdentityProvider |
400 | ID is not a number: %s | Malformatted patch identity provider request | |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to patch identity provider |
/api/v1/memo
GET
Summary
Get a list of memos matching optional filters
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
creatorId | query | Creator ID | No | integer |
creatorUsername | query | Creator username | No | string |
rowStatus | query | Row status | No | string |
pinned | query | Pinned | No | boolean |
tag | query | Search for tag. Do not append # | No | string |
content | query | Search for content | No | string |
limit | query | Limit | No | integer |
offset | query | Offset | No | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo list | [ store.Memo ] |
400 | Missing user to find memo | |
500 | Failed to get memo display with updated ts setting value | Failed to fetch memo list | Failed to compose memo response |
POST
Summary
Create a memo
Description
Visibility can be PUBLIC, PROTECTED or PRIVATE
*You should omit fields to use their default values
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object. | Yes | github_com_usememos_memos_api_v1.CreateMemoRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Stored memo | store.Memo |
400 | Malformatted post memo request | Content size overflow, up to 1MB | |
401 | Missing user in session | |
404 | User not found | Memo not found: %d | |
500 | Failed to find user setting | Failed to unmarshal user setting value | Failed to find system setting | Failed to unmarshal system setting | Failed to find user | Failed to create memo | Failed to create activity | Failed to upsert memo resource | Failed to upsert memo relation | Failed to compose memo | Failed to compose memo response |
/api/v1/memo/{memoId}
DELETE
Summary
Delete memo by ID
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | Memo ID to delete | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo deleted | boolean |
400 | ID is not a number: %s | |
401 | Missing user in session | Unauthorized | |
404 | Memo not found: %d | |
500 | Failed to find memo | Failed to delete memo ID: %v |
GET
Summary
Get memo by ID
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | Memo ID | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo list | [ store.Memo ] |
400 | ID is not a number: %s | |
401 | Missing user in session | |
403 | this memo is private only | this memo is protected, missing user in session | |
404 | Memo not found: %d | |
500 | Failed to find memo by ID: %v | Failed to compose memo response |
PATCH
Summary
Update a memo
Description
Visibility can be PUBLIC, PROTECTED or PRIVATE
*You should omit fields to use their default values
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | ID of memo to update | Yes | integer |
body | body | Patched object. | Yes | github_com_usememos_memos_api_v1.PatchMemoRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Stored memo | store.Memo |
400 | ID is not a number: %s | Malformatted patch memo request | Content size overflow, up to 1MB | |
401 | Missing user in session | Unauthorized | |
404 | Memo not found: %d | |
500 | Failed to find memo | Failed to patch memo | Failed to upsert memo resource | Failed to delete memo resource | Failed to compose memo response |
/api/v1/memo/all
GET
Summary
Get a list of public memos matching optional filters
Description
This should also list protected memos if the user is logged in
Authentication is optional
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
limit | query | Limit | No | integer |
offset | query | Offset | No | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo list | [ store.Memo ] |
500 | Failed to get memo display with updated ts setting value | Failed to fetch all memo list | Failed to compose memo response |
/api/v1/memo/stats
GET
Summary
Get memo stats by creator ID or username
Description
Used to generate the heatmap
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
creatorId | query | Creator ID | No | integer |
creatorUsername | query | Creator username | No | string |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo createdTs list | [ integer ] |
400 | Missing user id to find memo | |
500 | Failed to get memo display with updated ts setting value | Failed to find memo list | Failed to compose memo response |
/api/v1/memo/{memoId}/organizer
POST
Summary
Organize memo (pin/unpin)
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | ID of memo to organize | Yes | integer |
body | body | Memo organizer object | Yes | github_com_usememos_memos_api_v1.UpsertMemoOrganizerRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo information | store.Memo |
400 | ID is not a number: %s | Malformatted post memo organizer request | |
401 | Missing user in session | Unauthorized | |
404 | Memo not found: %v | |
500 | Failed to find memo | Failed to upsert memo organizer | Failed to find memo by ID: %v | Failed to compose memo response |
/api/v1/memo/{memoId}/relation
GET
Summary
Get a list of Memo Relations
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | ID of memo to find relations | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo relation information list | [ store.MemoRelation ] |
400 | ID is not a number: %s | |
500 | Failed to list memo relations |
POST
Summary
Create Memo Relation
Description
Create a relation between two memos
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | ID of memo to relate | Yes | integer |
body | body | Memo relation object | Yes | api_v1.UpsertMemoRelationRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo relation information | store.MemoRelation |
400 | ID is not a number: %s | Malformatted post memo relation request | |
500 | Failed to upsert memo relation |
/api/v1/memo/{memoId}/relation/{relatedMemoId}/type/{relationType}
DELETE
Summary
Delete a Memo Relation
Description
Removes a relation between two memos
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
memoId | path | ID of memo to find relations | Yes | integer |
relatedMemoId | path | ID of memo to remove relation to | Yes | integer |
relationType | path | Type of relation to remove | Yes | string |
Responses
Code | Description | Schema |
---|---|---|
200 | Memo relation deleted | boolean |
400 | Memo ID is not a number: %s | Related memo ID is not a number: %s | |
500 | Failed to delete memo relation |
/api/v1/ping
GET
Summary
Ping the system
Responses
Code | Description | Schema |
---|---|---|
200 | If succeed to ping the system | boolean |
/api/v1/status
GET
Summary
Get system GetSystemStatus
Responses
Code | Description | Schema |
---|---|---|
200 | System GetSystemStatus | github_com_usememos_memos_api_v1.SystemStatus |
401 | Missing user in session | Unauthorized | |
500 | Failed to find host user | Failed to find system setting list | Failed to unmarshal system setting customized profile value |
/api/v1/system/vacuum
POST
Summary
Vacuum the database
Responses
Code | Description | Schema |
---|---|---|
200 | Database vacuumed | boolean |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to ExecVacuum database |
/api/v1/resource
GET
Summary
Get a list of resources
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
limit | query | Limit | No | integer |
offset | query | Offset | No | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Resource list | [ store.Resource ] |
401 | Missing user in session | |
500 | Failed to fetch resource list |
POST
Summary
Create resource
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object. | Yes | github_com_usememos_memos_api_v1.CreateResourceRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Created resource | store.Resource |
400 | Malformatted post resource request | Invalid external link | Invalid external link scheme | Failed to request %s | Failed to read %s | Failed to read mime from %s | |
401 | Missing user in session | |
500 | Failed to save resource | Failed to create resource | Failed to create activity |
/api/v1/resource/{resourceId}
DELETE
Summary
Delete a resource
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
resourceId | path | Resource ID | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Resource deleted | boolean |
400 | ID is not a number: %s | |
401 | Missing user in session | |
404 | Resource not found: %d | |
500 | Failed to find resource | Failed to delete resource |
PATCH
Summary
Update a resource
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
resourceId | path | Resource ID | Yes | integer |
patch | body | Patch resource request | Yes | github_com_usememos_memos_api_v1.UpdateResourceRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Updated resource | store.Resource |
400 | ID is not a number: %s | Malformatted patch resource request | |
401 | Missing user in session | Unauthorized | |
404 | Resource not found: %d | |
500 | Failed to find resource | Failed to patch resource |
/api/v1/resource/blob
POST
Summary
Upload resource
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
file | formData | File to upload | Yes | file |
Responses
Code | Description | Schema |
---|---|---|
200 | Created resource | store.Resource |
400 | Upload file not found | File size exceeds allowed limit of %d MiB | Failed to parse upload data | |
401 | Missing user in session | |
500 | Failed to get uploading file | Failed to open file | Failed to save resource | Failed to create resource | Failed to create activity |
/api/v1/storage
GET
Summary
Get a list of storages
Responses
Code | Description | Schema |
---|---|---|
200 | List of storages | [ store.Storage ] |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to convert storage |
POST
Summary
Create storage
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object. | Yes | github_com_usememos_memos_api_v1.CreateStorageRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Created storage | store.Storage |
400 | Malformatted post storage request | |
401 | Missing user in session | |
500 | Failed to find user | Failed to create storage | Failed to convert storage |
/api/v1/storage/{storageId}
DELETE
Summary
Delete a storage
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
storageId | path | Storage ID | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Storage deleted | boolean |
400 | ID is not a number: %s | Storage service %d is using | |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to find storage | Failed to unmarshal storage service id | Failed to delete storage |
PATCH
Summary
Update a storage
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
storageId | path | Storage ID | Yes | integer |
patch | body | Patch request | Yes | github_com_usememos_memos_api_v1.UpdateStorageRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Updated resource | store.Storage |
400 | ID is not a number: %s | Malformatted patch storage request | Malformatted post storage request | |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to patch storage | Failed to convert storage |
/api/v1/system/setting
GET
Summary
Get a list of system settings
Responses
Code | Description | Schema |
---|---|---|
200 | System setting list | [ api_v1.SystemSetting ] |
401 | Missing user in session | Unauthorized | |
500 | Failed to find user | Failed to find system setting list |
POST
Summary
Create system setting
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object. | Yes | api_v1.UpsertSystemSettingRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Created system setting | store.SystemSetting |
400 | Malformatted post system setting request | invalid system setting | |
401 | Missing user in session | Unauthorized | |
403 | Cannot disable passwords if no SSO identity provider is configured. | |
500 | Failed to find user | Failed to upsert system setting |
/api/v1/tag
GET
Summary
Get a list of tags
Responses
Code | Description | Schema |
---|---|---|
200 | Tag list | [ string ] |
400 | Missing user id to find tag | |
500 | Failed to find tag list |
POST
Summary
Create a tag
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object. | Yes | github_com_usememos_memos_api_v1.UpsertTagRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Created tag name | string |
400 | Malformatted post tag request | Tag name shouldn’t be empty | |
401 | Missing user in session | |
500 | Failed to upsert tag | Failed to create activity |
/api/v1/tag/delete
POST
Summary
Delete a tag
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object. | Yes | github_com_usememos_memos_api_v1.DeleteTagRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Tag deleted | boolean |
400 | Malformatted post tag request | Tag name shouldn’t be empty | |
401 | Missing user in session | |
500 | Failed to delete tag name: %v |
/api/v1/tag/suggestion
GET
Summary
Get a list of tags suggested from other memos contents
Responses
Code | Description | Schema |
---|---|---|
200 | Tag list | [ string ] |
400 | Missing user session | |
500 | Failed to find memo list | Failed to find tag list |
/api/v1/user
GET
Summary
Get a list of users
Responses
Code | Description | Schema |
---|---|---|
200 | User list | [ store.User ] |
500 | Failed to fetch user list |
POST
Summary
Create a user
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
body | body | Request object | Yes | github_com_usememos_memos_api_v1.CreateUserRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Created user | store.User |
400 | Malformatted post user request | Invalid user create format | |
401 | Missing auth session | Unauthorized to create user | |
403 | Could not create host user | |
500 | Failed to find user by id | Failed to generate password hash | Failed to create user | Failed to create activity |
/api/v1/user/{id}
DELETE
Summary
Delete a user
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
id | path | User ID | Yes | string |
Responses
Code | Description | Schema |
---|---|---|
200 | User deleted | boolean |
400 | ID is not a number: %s | Current session user not found with ID: %d | |
401 | Missing user in session | |
403 | Unauthorized to delete user | |
500 | Failed to find user | Failed to delete user |
GET
Summary
Get user by id
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
id | path | User ID | Yes | integer |
Responses
Code | Description | Schema |
---|---|---|
200 | Requested user | store.User |
400 | Malformatted user id | |
404 | User not found | |
500 | Failed to find user |
PATCH
Summary
Update a user
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
id | path | User ID | Yes | string |
patch | body | Patch request | Yes | github_com_usememos_memos_api_v1.UpdateUserRequest |
Responses
Code | Description | Schema |
---|---|---|
200 | Updated user | store.User |
400 | ID is not a number: %s | Current session user not found with ID: %d | Malformatted patch user request | Invalid update user request | |
401 | Missing user in session | |
403 | Unauthorized to update user | |
500 | Failed to find user | Failed to generate password hash | Failed to patch user | Failed to find userSettingList |
/api/v1/user/me
GET
Summary
Get current user
Responses
Code | Description | Schema |
---|---|---|
200 | Current user | store.User |
401 | Missing auth session | |
500 | Failed to find user | Failed to find userSettingList |
/api/v1/user/name/{username}
GET
Summary
Get user by username
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
username | path | Username | Yes | string |
Responses
Code | Description | Schema |
---|---|---|
200 | Requested user | store.User |
404 | User not found | |
500 | Failed to find user |
/explore/rss.xml
GET
Summary
Get RSS
Responses
Code | Description |
---|---|
200 | RSS |
500 | Failed to get system customized profile | Failed to find memo list | Failed to generate rss |
/u/{id}/rss.xml
GET
Summary
Get RSS for a user
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
id | path | User ID | Yes | integer |
Responses
Code | Description |
---|---|
200 | RSS |
400 | User id is not a number |
500 | Failed to get system customized profile | Failed to find memo list | Failed to generate rss |
/o/get/GetImage
GET
Summary
Get GetImage from URL
Parameters
Name | Located in | Description | Required | Schema |
---|---|---|---|---|
url | query | Image url | Yes | string |
Responses
Code | Description |
---|---|
200 | Image |
400 | Missing GetImage url | Wrong url | Failed to get GetImage url: %s |
500 | Failed to write GetImage blob |
Models
api_v1.CreateIdentityProviderRequest
Name | Type | Description | Required |
---|---|---|---|
config | api_v1.IdentityProviderConfig | No | |
identifierFilter | string | No | |
name | string | No | |
type | api_v1.IdentityProviderType | No |
api_v1.CreateMemoRequest
Name | Type | Description | Required |
---|---|---|---|
content | string | No | |
createdTs | integer | No | |
relationList | [ api_v1.UpsertMemoRelationRequest ] | No | |
resourceIdList | [ integer ] | Related fields | No |
visibility | api_v1.Visibility | Domain specific fields | No |
api_v1.CreateResourceRequest
Name | Type | Description | Required |
---|---|---|---|
externalLink | string | No | |
filename | string | No | |
type | string | No |
api_v1.CreateStorageRequest
Name | Type | Description | Required |
---|---|---|---|
config | api_v1.StorageConfig | No | |
name | string | No | |
type | api_v1.StorageType | No |
api_v1.CreateUserRequest
Name | Type | Description | Required |
---|---|---|---|
string | No | ||
nickname | string | No | |
password | string | No | |
role | api_v1.Role | No | |
username | string | No |
api_v1.CustomizedProfile
Name | Type | Description | Required |
---|---|---|---|
appearance | string | Appearance is the server default appearance. | No |
description | string | Description is the server description. | No |
externalUrl | string | ExternalURL is the external url of server. e.g. usermemos.com | No |
locale | string | Locale is the server default locale. | No |
logoUrl | string | LogoURL is the url of logo image. | No |
name | string | Name is the server name, default is memos |
No |
api_v1.DeleteTagRequest
Name | Type | Description | Required |
---|---|---|---|
name | string | No |
api_v1.FieldMapping
Name | Type | Description | Required |
---|---|---|---|
displayName | string | No | |
string | No | ||
identifier | string | No |
api_v1.IdentityProvider
Name | Type | Description | Required |
---|---|---|---|
config | api_v1.IdentityProviderConfig | No | |
id | integer | No | |
identifierFilter | string | No | |
name | string | No | |
type | api_v1.IdentityProviderType | No |
api_v1.IdentityProviderConfig
Name | Type | Description | Required |
---|---|---|---|
oauth2Config | api_v1.IdentityProviderOAuth2Config | No |
api_v1.IdentityProviderOAuth2Config
Name | Type | Description | Required |
---|---|---|---|
authUrl | string | No | |
clientId | string | No | |
clientSecret | string | No | |
fieldMapping | api_v1.FieldMapping | No | |
scopes | [ string ] | No | |
tokenUrl | string | No | |
userInfoUrl | string | No |
api_v1.IdentityProviderType
Name | Type | Description | Required |
---|---|---|---|
api_v1.IdentityProviderType | string |
api_v1.MemoRelationType
Name | Type | Description | Required |
---|---|---|---|
api_v1.MemoRelationType | string |
api_v1.PatchMemoRequest
Name | Type | Description | Required |
---|---|---|---|
content | string | Domain specific fields | No |
createdTs | integer | Standard fields | No |
relationList | [ api_v1.UpsertMemoRelationRequest ] | No | |
resourceIdList | [ integer ] | Related fields | No |
rowStatus | api_v1.RowStatus | No | |
updatedTs | integer | No | |
visibility | api_v1.Visibility | No |
api_v1.Role
Name | Type | Description | Required |
---|---|---|---|
api_v1.Role | string |
api_v1.RowStatus
Name | Type | Description | Required |
---|---|---|---|
api_v1.RowStatus | string |
api_v1.SSOSignIn
Name | Type | Description | Required |
---|---|---|---|
code | string | No | |
identityProviderId | integer | No | |
redirectUri | string | No |
api_v1.SignIn
Name | Type | Description | Required |
---|---|---|---|
password | string | No | |
remember | boolean | No | |
username | string | No |
api_v1.SignUp
Name | Type | Description | Required |
---|---|---|---|
password | string | No | |
username | string | No |
api_v1.StorageConfig
Name | Type | Description | Required |
---|---|---|---|
s3Config | api_v1.StorageS3Config | No |
api_v1.StorageS3Config
Name | Type | Description | Required |
---|---|---|---|
accessKey | string | No | |
bucket | string | No | |
endPoint | string | No | |
path | string | No | |
region | string | No | |
secretKey | string | No | |
urlPrefix | string | No | |
urlSuffix | string | No |
api_v1.StorageType
Name | Type | Description | Required |
---|---|---|---|
api_v1.StorageType | string |
api_v1.SystemSetting
Name | Type | Description | Required |
---|---|---|---|
description | string | No | |
name | api_v1.SystemSettingName | No | |
value | string | Value is a JSON string with basic value. | No |
api_v1.SystemSettingName
Name | Type | Description | Required |
---|---|---|---|
api_v1.SystemSettingName | string |
api_v1.SystemStatus
Name | Type | Description | Required |
---|---|---|---|
additionalScript | string | Additional script. | No |
additionalStyle | string | Additional style. | No |
allowSignUp | boolean | System settings Allow sign up. | No |
customizedProfile | api_v1.CustomizedProfile | Customized server profile, including server name and external url. | No |
dbSize | integer | No | |
disablePasswordLogin | boolean | Disable password login. | No |
disablePublicMemos | boolean | Disable public memos. | No |
host | api_v1.User | No | |
localStoragePath | string | Local storage path. | No |
maxUploadSizeMiB | integer | Max upload size. | No |
memoDisplayWithUpdatedTs | boolean | Memo display with updated timestamp. | No |
profile | profile.Profile | No | |
storageServiceId | integer | Storage service ID. | No |
api_v1.UpdateIdentityProviderRequest
Name | Type | Description | Required |
---|---|---|---|
config | api_v1.IdentityProviderConfig | No | |
identifierFilter | string | No | |
name | string | No | |
type | api_v1.IdentityProviderType | No |
api_v1.UpdateResourceRequest
Name | Type | Description | Required |
---|---|---|---|
filename | string | No |
api_v1.UpdateStorageRequest
Name | Type | Description | Required |
---|---|---|---|
config | api_v1.StorageConfig | No | |
name | string | No | |
type | api_v1.StorageType | No |
api_v1.UpdateUserRequest
Name | Type | Description | Required |
---|---|---|---|
avatarUrl | string | No | |
string | No | ||
nickname | string | No | |
password | string | No | |
rowStatus | api_v1.RowStatus | No | |
username | string | No |
api_v1.UpsertMemoOrganizerRequest
Name | Type | Description | Required |
---|---|---|---|
pinned | boolean | No |
api_v1.UpsertMemoRelationRequest
Name | Type | Description | Required |
---|---|---|---|
relatedMemoId | integer | No | |
type | api_v1.MemoRelationType | No |
api_v1.UpsertSystemSettingRequest
Name | Type | Description | Required |
---|---|---|---|
description | string | No | |
name | api_v1.SystemSettingName | No | |
value | string | No |
api_v1.UpsertTagRequest
Name | Type | Description | Required |
---|---|---|---|
name | string | No |
api_v1.User
Name | Type | Description | Required |
---|---|---|---|
avatarUrl | string | No | |
createdTs | integer | No | |
string | No | ||
id | integer | No | |
nickname | string | No | |
role | api_v1.Role | No | |
rowStatus | api_v1.RowStatus | Standard fields | No |
updatedTs | integer | No | |
username | string | Domain specific fields | No |
api_v1.Visibility
Name | Type | Description | Required |
---|---|---|---|
api_v1.Visibility | string |
github_com_usememos_memos_api_v1.CreateIdentityProviderRequest
Name | Type | Description | Required |
---|---|---|---|
config | github_com_usememos_memos_api_v1.IdentityProviderConfig | No | |
identifierFilter | string | No | |
name | string | No | |
type | github_com_usememos_memos_api_v1.IdentityProviderType | No |
github_com_usememos_memos_api_v1.CreateMemoRequest
Name | Type | Description | Required |
---|---|---|---|
content | string | No | |
createdTs | integer | No | |
relationList | [ github_com_usememos_memos_api_v1.UpsertMemoRelationRequest ] | No | |
resourceIdList | [ integer ] | Related fields | No |
visibility | github_com_usememos_memos_api_v1.Visibility | Domain specific fields | No |
github_com_usememos_memos_api_v1.CreateResourceRequest
Name | Type | Description | Required |
---|---|---|---|
externalLink | string | No | |
filename | string | No | |
type | string | No |
github_com_usememos_memos_api_v1.CreateStorageRequest
Name | Type | Description | Required |
---|---|---|---|
config | github_com_usememos_memos_api_v1.StorageConfig | No | |
name | string | No | |
type | github_com_usememos_memos_api_v1.StorageType | No |
github_com_usememos_memos_api_v1.CreateUserRequest
Name | Type | Description | Required |
---|---|---|---|
string | No | ||
nickname | string | No | |
password | string | No | |
role | github_com_usememos_memos_api_v1.Role | No | |
username | string | No |
github_com_usememos_memos_api_v1.CustomizedProfile
Name | Type | Description | Required |
---|---|---|---|
appearance | string | Appearance is the server default appearance. | No |
description | string | Description is the server description. | No |
externalUrl | string | ExternalURL is the external url of server. e.g. usermemos.com | No |
locale | string | Locale is the server default locale. | No |
logoUrl | string | LogoURL is the url of logo image. | No |
name | string | Name is the server name, default is memos |
No |
github_com_usememos_memos_api_v1.DeleteTagRequest
Name | Type | Description | Required |
---|---|---|---|
name | string | No |
github_com_usememos_memos_api_v1.FieldMapping
Name | Type | Description | Required |
---|---|---|---|
displayName | string | No | |
string | No | ||
identifier | string | No |
github_com_usememos_memos_api_v1.IdentityProvider
Name | Type | Description | Required |
---|---|---|---|
config | github_com_usememos_memos_api_v1.IdentityProviderConfig | No | |
id | integer | No | |
identifierFilter | string | No | |
name | string | No | |
type | github_com_usememos_memos_api_v1.IdentityProviderType | No |
github_com_usememos_memos_api_v1.IdentityProviderConfig
Name | Type | Description | Required |
---|---|---|---|
oauth2Config | github_com_usememos_memos_api_v1.IdentityProviderOAuth2Config | No |
github_com_usememos_memos_api_v1.IdentityProviderOAuth2Config
Name | Type | Description | Required |
---|---|---|---|
authUrl | string | No | |
clientId | string | No | |
clientSecret | string | No | |
fieldMapping | github_com_usememos_memos_api_v1.FieldMapping | No | |
scopes | [ string ] | No | |
tokenUrl | string | No | |
userInfoUrl | string | No |
github_com_usememos_memos_api_v1.IdentityProviderType
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.IdentityProviderType | string |
github_com_usememos_memos_api_v1.MemoRelationType
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.MemoRelationType | string |
github_com_usememos_memos_api_v1.PatchMemoRequest
Name | Type | Description | Required |
---|---|---|---|
content | string | Domain specific fields | No |
createdTs | integer | Standard fields | No |
relationList | [ github_com_usememos_memos_api_v1.UpsertMemoRelationRequest ] | No | |
resourceIdList | [ integer ] | Related fields | No |
rowStatus | github_com_usememos_memos_api_v1.RowStatus | No | |
updatedTs | integer | No | |
visibility | github_com_usememos_memos_api_v1.Visibility | No |
github_com_usememos_memos_api_v1.Role
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.Role | string |
github_com_usememos_memos_api_v1.RowStatus
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.RowStatus | string |
github_com_usememos_memos_api_v1.SSOSignIn
Name | Type | Description | Required |
---|---|---|---|
code | string | No | |
identityProviderId | integer | No | |
redirectUri | string | No |
github_com_usememos_memos_api_v1.SignIn
Name | Type | Description | Required |
---|---|---|---|
password | string | No | |
remember | boolean | No | |
username | string | No |
github_com_usememos_memos_api_v1.SignUp
Name | Type | Description | Required |
---|---|---|---|
password | string | No | |
username | string | No |
github_com_usememos_memos_api_v1.StorageConfig
Name | Type | Description | Required |
---|---|---|---|
s3Config | github_com_usememos_memos_api_v1.StorageS3Config | No |
github_com_usememos_memos_api_v1.StorageS3Config
Name | Type | Description | Required |
---|---|---|---|
accessKey | string | No | |
bucket | string | No | |
endPoint | string | No | |
path | string | No | |
region | string | No | |
secretKey | string | No | |
urlPrefix | string | No | |
urlSuffix | string | No |
github_com_usememos_memos_api_v1.StorageType
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.StorageType | string |
github_com_usememos_memos_api_v1.SystemSetting
Name | Type | Description | Required |
---|---|---|---|
description | string | No | |
name | github_com_usememos_memos_api_v1.SystemSettingName | No | |
value | string | Value is a JSON string with basic value. | No |
github_com_usememos_memos_api_v1.SystemSettingName
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.SystemSettingName | string |
github_com_usememos_memos_api_v1.SystemStatus
Name | Type | Description | Required |
---|---|---|---|
additionalScript | string | Additional script. | No |
additionalStyle | string | Additional style. | No |
allowSignUp | boolean | System settings Allow sign up. | No |
customizedProfile | github_com_usememos_memos_api_v1.CustomizedProfile | Customized server profile, including server name and external url. | No |
dbSize | integer | No | |
disablePasswordLogin | boolean | Disable password login. | No |
disablePublicMemos | boolean | Disable public memos. | No |
host | github_com_usememos_memos_api_v1.User | No | |
localStoragePath | string | Local storage path. | No |
maxUploadSizeMiB | integer | Max upload size. | No |
memoDisplayWithUpdatedTs | boolean | Memo display with updated timestamp. | No |
profile | profile.Profile | No | |
storageServiceId | integer | Storage service ID. | No |
github_com_usememos_memos_api_v1.UpdateIdentityProviderRequest
Name | Type | Description | Required |
---|---|---|---|
config | github_com_usememos_memos_api_v1.IdentityProviderConfig | No | |
identifierFilter | string | No | |
name | string | No | |
type | github_com_usememos_memos_api_v1.IdentityProviderType | No |
github_com_usememos_memos_api_v1.UpdateResourceRequest
Name | Type | Description | Required |
---|---|---|---|
filename | string | No |
github_com_usememos_memos_api_v1.UpdateStorageRequest
Name | Type | Description | Required |
---|---|---|---|
config | github_com_usememos_memos_api_v1.StorageConfig | No | |
name | string | No | |
type | github_com_usememos_memos_api_v1.StorageType | No |
github_com_usememos_memos_api_v1.UpdateUserRequest
Name | Type | Description | Required |
---|---|---|---|
avatarUrl | string | No | |
string | No | ||
nickname | string | No | |
password | string | No | |
rowStatus | github_com_usememos_memos_api_v1.RowStatus | No | |
username | string | No |
github_com_usememos_memos_api_v1.UpsertMemoOrganizerRequest
Name | Type | Description | Required |
---|---|---|---|
pinned | boolean | No |
github_com_usememos_memos_api_v1.UpsertMemoRelationRequest
Name | Type | Description | Required |
---|---|---|---|
relatedMemoId | integer | No | |
type | github_com_usememos_memos_api_v1.MemoRelationType | No |
github_com_usememos_memos_api_v1.UpsertSystemSettingRequest
Name | Type | Description | Required |
---|---|---|---|
description | string | No | |
name | github_com_usememos_memos_api_v1.SystemSettingName | No | |
value | string | No |
github_com_usememos_memos_api_v1.UpsertTagRequest
Name | Type | Description | Required |
---|---|---|---|
name | string | No |
github_com_usememos_memos_api_v1.User
Name | Type | Description | Required |
---|---|---|---|
avatarUrl | string | No | |
createdTs | integer | No | |
string | No | ||
id | integer | No | |
nickname | string | No | |
role | github_com_usememos_memos_api_v1.Role | No | |
rowStatus | github_com_usememos_memos_api_v1.RowStatus | Standard fields | No |
updatedTs | integer | No | |
username | string | Domain specific fields | No |
github_com_usememos_memos_api_v1.Visibility
Name | Type | Description | Required |
---|---|---|---|
github_com_usememos_memos_api_v1.Visibility | string |
profile.Profile
Name | Type | Description | Required |
---|---|---|---|
mode | string | Mode can be “prod” or “dev” or “demo” | No |
version | string | Version is the current version of server | No |
store.FieldMapping
Name | Type | Description | Required |
---|---|---|---|
displayName | string | No | |
string | No | ||
identifier | string | No |
store.IdentityProvider
Name | Type | Description | Required |
---|---|---|---|
config | store.IdentityProviderConfig | No | |
id | integer | No | |
identifierFilter | string | No | |
name | string | No | |
type | store.IdentityProviderType | No |
store.IdentityProviderConfig
Name | Type | Description | Required |
---|---|---|---|
oauth2Config | store.IdentityProviderOAuth2Config | No |
store.IdentityProviderOAuth2Config
Name | Type | Description | Required |
---|---|---|---|
authUrl | string | No | |
clientId | string | No | |
clientSecret | string | No | |
fieldMapping | store.FieldMapping | No | |
scopes | [ string ] | No | |
tokenUrl | string | No | |
userInfoUrl | string | No |
store.IdentityProviderType
Name | Type | Description | Required |
---|---|---|---|
store.IdentityProviderType | string |
store.Memo
Name | Type | Description | Required |
---|---|---|---|
content | string | Domain specific fields | No |
createdTs | integer | No | |
creatorID | integer | No | |
id | integer | No | |
pinned | boolean | Composed fields | No |
rowStatus | store.RowStatus | Standard fields | No |
updatedTs | integer | No | |
visibility | store.Visibility | No |
store.MemoRelation
Name | Type | Description | Required |
---|---|---|---|
memoID | integer | No | |
relatedMemoID | integer | No | |
type | store.MemoRelationType | No |
store.MemoRelationType
Name | Type | Description | Required |
---|---|---|---|
store.MemoRelationType | string |
store.Resource
Name | Type | Description | Required |
---|---|---|---|
blob | [ integer ] | No | |
createdTs | integer | No | |
creatorID | integer | Standard fields | No |
externalLink | string | No | |
filename | string | Domain specific fields | No |
id | integer | No | |
internalPath | string | No | |
memoID | integer | No | |
size | integer | No | |
type | string | No | |
updatedTs | integer | No |
store.Role
Name | Type | Description | Required |
---|---|---|---|
store.Role | string |
store.RowStatus
Name | Type | Description | Required |
---|---|---|---|
store.RowStatus | string |
store.Storage
Name | Type | Description | Required |
---|---|---|---|
config | string | No | |
id | integer | No | |
name | string | No | |
type | string | No |
store.SystemSetting
Name | Type | Description | Required |
---|---|---|---|
description | string | No | |
name | string | No | |
value | string | No |
store.User
Name | Type | Description | Required |
---|---|---|---|
avatarURL | string | No | |
createdTs | integer | No | |
string | No | ||
id | integer | No | |
nickname | string | No | |
passwordHash | string | No | |
role | store.Role | No | |
rowStatus | store.RowStatus | Standard fields | No |
updatedTs | integer | No | |
username | string | Domain specific fields | No |
store.Visibility
Name | Type | Description | Required |
---|---|---|---|
store.Visibility | string |
本作品采用《CC 协议》,转载必须注明作者和本文链接