// @Failure 401 {object} nil "Missing user in session"
// @Failure 404 {object} nil "User not found | Memo not found: %d"
// @Failure 500 {object} nil "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"
// @Failure 500 {object} nil "Failed to get memo display with updated ts setting value | Failed to fetch all memo list | Failed to compose memo response"
// @Failure 400 {object} nil "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"
// @Failure 401 {object} nil "Missing user in session"
// @Failure 500 {object} nil "Failed to save resource | Failed to create resource | Failed to create activity"
// @Failure 400 {object} nil "Upload file not found | File size exceeds allowed limit of %d MiB | Failed to parse upload data"
// @Failure 401 {object} nil "Missing user in session"
// @Failure 500 {object} nil "Failed to get uploading file | Failed to open file | Failed to save resource | Failed to create resource | Failed to create activity"
[Find out more about Memos](https://usememos.com/)
### Security
**ApiKeyAuth**
| apiKey | *API Key* |
| ------ | --------- |
| Description | Insert your Open ID API Key here. |
| In | query |
| Name | openId |
[Find out more about Memos.](https://usememos.com/)
---
### /api/v1/auth/signin
@ -144,12 +135,6 @@ Create Identity Provider
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to create identity provider | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/idp/{idpId}
#### DELETE
@ -172,12 +157,6 @@ Delete an identity provider by ID
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to patch identity provider | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### GET
##### Summary
@ -199,12 +178,6 @@ Get an identity provider by ID
| 404 | Identity provider not found | |
| 500 | Failed to find identity provider list \| Failed to find user | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### PATCH
##### Summary
@ -226,12 +199,6 @@ Update an identity provider by ID
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to patch identity provider | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /api/v1/memo
@ -261,12 +228,6 @@ Get a list of memos matching optional filters
| 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 | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### POST
##### Summary
@ -293,12 +254,6 @@ Visibility can be PUBLIC, PROTECTED or PRIVATE
| 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 | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/memo/{memoId}
#### DELETE
@ -322,12 +277,6 @@ Delete memo by ID
| 404 | Memo not found: %d | |
| 500 | Failed to find memo \| Failed to delete memo ID: %v | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### GET
##### Summary
@ -377,12 +326,6 @@ Visibility can be PUBLIC, PROTECTED or PRIVATE
| 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 | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/memo/all
#### GET
@ -409,12 +352,6 @@ Authentication is optional
| 200 | Memo list | [ [store.Memo](#storememo) ] |
| 500 | Failed to get memo display with updated ts setting value \| Failed to fetch all memo list \| Failed to compose memo response | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/memo/stats
#### GET
@ -466,12 +403,6 @@ Organize memo (pin/unpin)
| 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 | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /api/v1/memo/{memoId}/relation
@ -588,12 +519,6 @@ Bind resource to memo
| 401 | Missing user in session \| Unauthorized to bind this resource | |
| 500 | Failed to fetch resource \| Failed to upsert memo resource | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/memo/{memoId}/resource/{resourceId}
#### DELETE
@ -617,12 +542,6 @@ Unbind resource from memo
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find memo \| Failed to fetch resource list | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /api/v1/ping
@ -635,20 +554,20 @@ Ping the system
| Code | Description | Schema |
| ---- | ----------- | ------ |
| 200 | System profile | [profile.Profile](#profileprofile) |
| 200 | If succeed to ping the system | boolean |
### /api/v1/status
#### GET
##### Summary
Get system status
Get system GetSystemStatus
##### Responses
| Code | Description | Schema |
| ---- | ----------- | ------ |
| 200 | System status | [v1.SystemStatus](#v1systemstatus) |
| 200 | System GetSystemStatus | [v1.SystemStatus](#v1systemstatus) |
| 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 | |
@ -665,13 +584,7 @@ Vacuum the database
| ---- | ----------- | ------ |
| 200 | Database vacuumed | boolean |
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to vacuum database | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
| 500 | Failed to find user \| Failed to ExecVacuum database | |
---
### /api/v1/resource
@ -696,12 +609,6 @@ Get a list of resources
| 401 | Missing user in session | |
| 500 | Failed to fetch resource list | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### POST
##### Summary
@ -722,12 +629,6 @@ Create resource
| 401 | Missing user in session | |
| 500 | Failed to save resource \| Failed to create resource \| Failed to create activity | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/resource/{resourceId}
#### DELETE
@ -751,12 +652,6 @@ Delete a resource
| 404 | Resource not found: %d | |
| 500 | Failed to find resource \| Failed to delete resource | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### PATCH
##### Summary
@ -779,12 +674,6 @@ Update a resource
| 404 | Resource not found: %d | |
| 500 | Failed to find resource \| Failed to patch resource | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/resource/blob
#### POST
@ -807,12 +696,6 @@ Upload resource
| 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 | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /o/r/{resourceId}
#### GET
@ -857,12 +740,6 @@ Get a list of storages
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to convert storage | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### POST
##### Summary
@ -883,12 +760,6 @@ Create storage
| 401 | Missing user in session | |
| 500 | Failed to find user \| Failed to create storage \| Failed to convert storage | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/storage/{storageId}
#### DELETE
@ -911,12 +782,6 @@ Delete a storage
| 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 | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### PATCH
##### Summary
@ -938,12 +803,6 @@ Update a storage
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to patch storage \| Failed to convert storage | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /api/v1/system/setting
@ -960,12 +819,6 @@ Get a list of system settings
| 401 | Missing user in session \| Unauthorized | |
| 500 | Failed to find user \| Failed to find system setting list | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### POST
##### Summary
@ -987,12 +840,6 @@ Create system setting
| 403 | Cannot disable passwords if no SSO identity provider is configured. | |
| 500 | Failed to find user \| Failed to upsert system setting | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /api/v1/tag
@ -1009,12 +856,6 @@ Get a list of tags
| 400 | Missing user id to find tag | |
| 500 | Failed to find tag list | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
#### POST
##### Summary
@ -1035,12 +876,6 @@ Create a tag
| 401 | Missing user in session | |
| 500 | Failed to upsert tag \| Failed to create activity | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/tag/delete
#### POST
@ -1063,12 +898,6 @@ Delete a tag
| 401 | Missing user in session | |
| 500 | Failed to delete tag name: %v | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/tag/suggestion
#### GET
@ -1084,12 +913,6 @@ Get a list of tags suggested from other memos contents
| 400 | Missing user session | |
| 500 | Failed to find memo list \| Failed to find tag list | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /api/v1/user
@ -1206,12 +1029,6 @@ Get current user
| 401 | Missing auth session | |
| 500 | Failed to find user \| Failed to find userSettingList | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
### /api/v1/user/name/{username}
#### GET
@ -1239,7 +1056,7 @@ Get user by username
#### POST
##### Summary
Create user setting
Upsert user setting
##### Parameters
@ -1251,17 +1068,11 @@ Create user setting
| Code | Description | Schema |
| ---- | ----------- | ------ |
| 200 | Created user setting | [store.UserSetting](#storeusersetting) |
| 200 | Created user setting | [github_com_usememos_memos_store.UserSetting](#github_com_usememos_memos_storeusersetting) |
| 400 | Malformatted post user setting upsert request \| Invalid user setting format | |
| 401 | Missing auth session | |
| 500 | Failed to upsert user setting | |
##### Security
| Security Schema | Scopes |
| --------------- | ------ |
| ApiKeyAuth | |
---
### /explore/rss.xml
@ -1299,47 +1110,47 @@ Get RSS for a user
| 500 | Failed to get system customized profile \| Failed to find memo list \| Failed to generate rss |
---
### /o/get/httpmeta
### /o/get/GetImage
#### GET
##### Summary
Get website metadata
Get GetImage from URL
##### Parameters
| Name | Located in | Description | Required | Schema |