You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
4145 lines
105 KiB
4145 lines
105 KiB
{ |
|
"openapi": "3.1.0", |
|
"info": { |
|
"title": "Nextcloud", |
|
"version": "26.0.1", |
|
"description": "All supported Nextcloud APIs in one", |
|
"license": { |
|
"name": "agpl", |
|
"identifier": "AGPL-3.0" |
|
} |
|
}, |
|
"servers": [ |
|
{ |
|
"url": "https://{hostname}:{port}", |
|
"variables": { |
|
"hostname": { |
|
"default": "localhost" |
|
}, |
|
"port": { |
|
"default": "8080" |
|
} |
|
} |
|
} |
|
], |
|
"security": [ |
|
{ |
|
"basic_auth": [] |
|
} |
|
], |
|
"tags": [], |
|
"components": { |
|
"schemas": { |
|
"OCSMeta": { |
|
"type": "object", |
|
"required": [ |
|
"status", |
|
"statuscode" |
|
], |
|
"properties": { |
|
"status": { |
|
"type": "string" |
|
}, |
|
"statuscode": { |
|
"type": "integer" |
|
}, |
|
"message": { |
|
"type": "string" |
|
}, |
|
"totalitems": { |
|
"type": "string" |
|
}, |
|
"itemsperpage": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"EmptyOCS": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "array" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"CoreServerStatus": { |
|
"type": "object", |
|
"required": [ |
|
"installed", |
|
"maintenance", |
|
"needsDbUpgrade", |
|
"version", |
|
"versionstring", |
|
"edition", |
|
"productname", |
|
"extendedSupport" |
|
], |
|
"properties": { |
|
"installed": { |
|
"type": "boolean" |
|
}, |
|
"maintenance": { |
|
"type": "boolean" |
|
}, |
|
"needsDbUpgrade": { |
|
"type": "boolean" |
|
}, |
|
"version": { |
|
"type": "string" |
|
}, |
|
"versionstring": { |
|
"type": "string" |
|
}, |
|
"edition": { |
|
"type": "string" |
|
}, |
|
"productname": { |
|
"type": "string" |
|
}, |
|
"extendedSupport": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"CoreServerCapabilities": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "object", |
|
"required": [ |
|
"version", |
|
"capabilities" |
|
], |
|
"properties": { |
|
"version": { |
|
"type": "object", |
|
"properties": { |
|
"major": { |
|
"type": "integer" |
|
}, |
|
"minor": { |
|
"type": "integer" |
|
}, |
|
"micro": { |
|
"type": "integer" |
|
}, |
|
"string": { |
|
"type": "string" |
|
}, |
|
"edition": { |
|
"type": "string" |
|
}, |
|
"extendedSupport": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"capabilities": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"core": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"pollinterval": { |
|
"type": "integer" |
|
}, |
|
"webdav-root": { |
|
"type": "string" |
|
}, |
|
"reference-api": { |
|
"type": "boolean" |
|
}, |
|
"reference-regex": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"bruteforce": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"delay": { |
|
"type": "integer" |
|
} |
|
} |
|
}, |
|
"metadataAvailable": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"size": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"gps": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
}, |
|
"files": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"bigfilechunking": { |
|
"type": "boolean" |
|
}, |
|
"blacklisted_files": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"directEditing": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"url": { |
|
"type": "string" |
|
}, |
|
"etag": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"comments": { |
|
"type": "boolean" |
|
}, |
|
"undelete": { |
|
"type": "boolean" |
|
}, |
|
"versioning": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"activity": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"apiv2": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
}, |
|
"circles": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"version": { |
|
"type": "string" |
|
}, |
|
"status": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"globalScale": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"settings": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"frontendEnabled": { |
|
"type": "boolean" |
|
}, |
|
"allowedCircles": { |
|
"type": "integer" |
|
}, |
|
"allowedUserTypes": { |
|
"type": "integer" |
|
}, |
|
"membersLimit": { |
|
"type": "integer" |
|
} |
|
} |
|
}, |
|
"circle": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"constants": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"flags": { |
|
"type": "object" |
|
}, |
|
"source": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"core": { |
|
"type": "object" |
|
}, |
|
"extra": { |
|
"type": "object" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"config": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"coreFlags": { |
|
"type": "array", |
|
"items": { |
|
"type": "integer" |
|
} |
|
}, |
|
"systemFlags": { |
|
"type": "array", |
|
"items": { |
|
"type": "integer" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"member": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"constants": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"level": { |
|
"type": "object" |
|
} |
|
} |
|
}, |
|
"type": { |
|
"type": "object" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"ocm": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"apiVersion": { |
|
"type": "string" |
|
}, |
|
"endPoint": { |
|
"type": "string" |
|
}, |
|
"resourceTypes": { |
|
"type": "array", |
|
"items": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"name": { |
|
"type": "string" |
|
}, |
|
"shareTypes": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"protocols": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"webdav": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"dav": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"bulkupload": { |
|
"type": "string" |
|
}, |
|
"chunking": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"files_sharing": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"api_enabled": { |
|
"type": "boolean" |
|
}, |
|
"public": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"password": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enforced": { |
|
"type": "boolean" |
|
}, |
|
"askForOptionalPassword": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"expire_date": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"multiple_links": { |
|
"type": "boolean" |
|
}, |
|
"expire_date_internal": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"expire_date_remote": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"send_mail": { |
|
"type": "boolean" |
|
}, |
|
"upload": { |
|
"type": "boolean" |
|
}, |
|
"upload_files_drop": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"resharing": { |
|
"type": "boolean" |
|
}, |
|
"user": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"send_mail": { |
|
"type": "boolean" |
|
}, |
|
"expire_date": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"group_sharing": { |
|
"type": "boolean" |
|
}, |
|
"group": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"expire_date": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"default_permissions": { |
|
"type": "integer" |
|
}, |
|
"federation": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"outgoing": { |
|
"type": "boolean" |
|
}, |
|
"incoming": { |
|
"type": "boolean" |
|
}, |
|
"expire_date": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"expire_date_supported": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"sharee": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"query_lookup_default": { |
|
"type": "boolean" |
|
}, |
|
"always_show_unique": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"sharebymail": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"send_password_by_mail": { |
|
"type": "boolean" |
|
}, |
|
"upload_files_drop": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"password": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"enforced": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"expire_date": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"enforced": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"notes": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"api_version": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"version": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"notifications": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"ocs-endpoints": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"push": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"admin-notifications": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
}, |
|
"password_policy": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"minLength": { |
|
"type": "integer" |
|
}, |
|
"enforceNonCommonPassword": { |
|
"type": "boolean" |
|
}, |
|
"enforceNumericCharacters": { |
|
"type": "boolean" |
|
}, |
|
"enforceSpecialCharacters": { |
|
"type": "boolean" |
|
}, |
|
"enforceUpperLowerCase": { |
|
"type": "boolean" |
|
}, |
|
"api": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"generate": { |
|
"type": "string" |
|
}, |
|
"validate": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"provisioning_api": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"version": { |
|
"type": "string" |
|
}, |
|
"AccountPropertyScopesVersion": { |
|
"type": "integer" |
|
}, |
|
"AccountPropertyScopesFederatedEnabled": { |
|
"type": "boolean" |
|
}, |
|
"AccountPropertyScopesPublishedEnabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"theming": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"name": { |
|
"type": "string" |
|
}, |
|
"url": { |
|
"type": "string" |
|
}, |
|
"slogan": { |
|
"type": "string" |
|
}, |
|
"color": { |
|
"type": "string" |
|
}, |
|
"color-text": { |
|
"type": "string" |
|
}, |
|
"color-element": { |
|
"type": "string" |
|
}, |
|
"color-element-bright": { |
|
"type": "string" |
|
}, |
|
"color-element-dark": { |
|
"type": "string" |
|
}, |
|
"logo": { |
|
"type": "string" |
|
}, |
|
"background": { |
|
"type": "string" |
|
}, |
|
"background-plain": { |
|
"type": "boolean" |
|
}, |
|
"background-default": { |
|
"type": "boolean" |
|
}, |
|
"logoheader": { |
|
"type": "string" |
|
}, |
|
"favicon": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"user_status": { |
|
"type": "object", |
|
"additionalProperties": true, |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"supports_emoji": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"weather_status": { |
|
"type": "object", |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"CoreNavigationApps": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "array", |
|
"items": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"order", |
|
"href", |
|
"icon", |
|
"type", |
|
"name", |
|
"active", |
|
"classes", |
|
"unread" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "string" |
|
}, |
|
"order": { |
|
"description": "Should always be an integer, but there is a bug. See https://github.com/nextcloud/server/issues/32828", |
|
"oneOf": [ |
|
{ |
|
"type": "integer" |
|
}, |
|
{ |
|
"type": "string" |
|
} |
|
] |
|
}, |
|
"href": { |
|
"type": "string" |
|
}, |
|
"icon": { |
|
"type": "string" |
|
}, |
|
"type": { |
|
"type": "string" |
|
}, |
|
"name": { |
|
"type": "string" |
|
}, |
|
"active": { |
|
"type": "boolean" |
|
}, |
|
"classes": { |
|
"type": "string" |
|
}, |
|
"unread": { |
|
"type": "integer" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"CoreLoginFlowInit": { |
|
"type": "object", |
|
"required": [ |
|
"poll", |
|
"login" |
|
], |
|
"properties": { |
|
"poll": { |
|
"type": "object", |
|
"required": [ |
|
"token", |
|
"endpoint" |
|
], |
|
"properties": { |
|
"token": { |
|
"type": "string" |
|
}, |
|
"endpoint": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"login": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"CoreLoginFlowResult": { |
|
"type": "object", |
|
"required": [ |
|
"server", |
|
"loginName", |
|
"appPassword" |
|
], |
|
"properties": { |
|
"server": { |
|
"type": "string" |
|
}, |
|
"loginName": { |
|
"type": "string" |
|
}, |
|
"appPassword": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"CoreAutocompleteResult": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "array", |
|
"items": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"label", |
|
"icon", |
|
"source", |
|
"status", |
|
"subline", |
|
"shareWithDisplayNameUnique" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "string" |
|
}, |
|
"label": { |
|
"type": "string" |
|
}, |
|
"icon": { |
|
"type": "string" |
|
}, |
|
"source": { |
|
"type": "string" |
|
}, |
|
"status": { |
|
"oneOf": [ |
|
{ |
|
"type": "array", |
|
"items": { |
|
"type": "object" |
|
} |
|
}, |
|
{ |
|
"type": "string" |
|
} |
|
] |
|
}, |
|
"subline": { |
|
"type": "string" |
|
}, |
|
"shareWithDisplayNameUnique": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"NewsListFeeds": { |
|
"type": "object", |
|
"required": [ |
|
"feeds" |
|
], |
|
"properties": { |
|
"starredCount": { |
|
"type": "integer" |
|
}, |
|
"newestItemId": { |
|
"type": "integer" |
|
}, |
|
"feeds": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NewsFeed" |
|
} |
|
} |
|
} |
|
}, |
|
"NewsFeed": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"url", |
|
"title", |
|
"added", |
|
"ordering", |
|
"pinned", |
|
"updateErrorCount", |
|
"items" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "integer" |
|
}, |
|
"url": { |
|
"type": "string" |
|
}, |
|
"title": { |
|
"type": "string" |
|
}, |
|
"faviconLink": { |
|
"type": "string" |
|
}, |
|
"added": { |
|
"type": "integer" |
|
}, |
|
"folderId": { |
|
"type": "integer" |
|
}, |
|
"unreadCount": { |
|
"type": "integer" |
|
}, |
|
"ordering": { |
|
"type": "integer" |
|
}, |
|
"link": { |
|
"type": "string" |
|
}, |
|
"pinned": { |
|
"type": "boolean" |
|
}, |
|
"updateErrorCount": { |
|
"type": "integer" |
|
}, |
|
"lastUpdateError": { |
|
"type": "string" |
|
}, |
|
"items": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NewsArticle" |
|
} |
|
} |
|
} |
|
}, |
|
"NewsArticle": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"guid", |
|
"guidHash", |
|
"title", |
|
"pubDate", |
|
"body", |
|
"feedId", |
|
"unread", |
|
"starred", |
|
"lastModified", |
|
"rtl", |
|
"fingerprint", |
|
"contentHash" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "integer" |
|
}, |
|
"guid": { |
|
"type": "string" |
|
}, |
|
"guidHash": { |
|
"type": "string" |
|
}, |
|
"url": { |
|
"type": "string" |
|
}, |
|
"title": { |
|
"type": "string" |
|
}, |
|
"author": { |
|
"type": "string" |
|
}, |
|
"pubDate": { |
|
"type": "integer" |
|
}, |
|
"updatedDate": { |
|
"type": "integer" |
|
}, |
|
"body": { |
|
"type": "string" |
|
}, |
|
"enclosureMime": { |
|
"type": "string" |
|
}, |
|
"enclosureLink": { |
|
"type": "string" |
|
}, |
|
"mediaThumbnail": { |
|
"type": "string" |
|
}, |
|
"mediaDescription": { |
|
"type": "string" |
|
}, |
|
"feedId": { |
|
"type": "integer" |
|
}, |
|
"unread": { |
|
"type": "boolean" |
|
}, |
|
"starred": { |
|
"type": "boolean" |
|
}, |
|
"lastModified": { |
|
"type": "integer" |
|
}, |
|
"rtl": { |
|
"type": "boolean" |
|
}, |
|
"fingerprint": { |
|
"type": "string" |
|
}, |
|
"contentHash": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"NewsListArticles": { |
|
"type": "object", |
|
"required": [ |
|
"items" |
|
], |
|
"properties": { |
|
"items": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NewsArticle" |
|
} |
|
} |
|
} |
|
}, |
|
"NewsListFolders": { |
|
"type": "object", |
|
"required": [ |
|
"folders" |
|
], |
|
"properties": { |
|
"folders": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NewsFolder" |
|
} |
|
} |
|
} |
|
}, |
|
"NewsFolder": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"name", |
|
"opened", |
|
"feeds" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "integer" |
|
}, |
|
"name": { |
|
"type": "string" |
|
}, |
|
"opened": { |
|
"type": "boolean" |
|
}, |
|
"feeds": { |
|
"description": "This seems to be broken. In testing it is always empty", |
|
"deprecated": true, |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NewsFeed" |
|
} |
|
} |
|
} |
|
}, |
|
"NewsSupportedAPIVersions": { |
|
"type": "object", |
|
"properties": { |
|
"apiLevels": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
}, |
|
"NotesNote": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"etag", |
|
"readonly", |
|
"content", |
|
"title", |
|
"category", |
|
"favorite", |
|
"modified", |
|
"error", |
|
"errorType" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "integer" |
|
}, |
|
"etag": { |
|
"type": "string" |
|
}, |
|
"readonly": { |
|
"type": "boolean" |
|
}, |
|
"content": { |
|
"type": "string" |
|
}, |
|
"title": { |
|
"type": "string" |
|
}, |
|
"category": { |
|
"type": "string" |
|
}, |
|
"favorite": { |
|
"type": "boolean" |
|
}, |
|
"modified": { |
|
"type": "integer" |
|
}, |
|
"error": { |
|
"type": "boolean" |
|
}, |
|
"errorType": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"NotesSettings": { |
|
"type": "object", |
|
"required": [ |
|
"notesPath", |
|
"fileSuffix", |
|
"noteMode" |
|
], |
|
"properties": { |
|
"notesPath": { |
|
"type": "string" |
|
}, |
|
"fileSuffix": { |
|
"type": "string" |
|
}, |
|
"noteMode": { |
|
"type": "string", |
|
"enum": [ |
|
"edit", |
|
"preview", |
|
"rich" |
|
] |
|
} |
|
} |
|
}, |
|
"NotificationsNotification": { |
|
"type": "object", |
|
"required": [ |
|
"notification_id", |
|
"app", |
|
"user", |
|
"datetime", |
|
"object_type", |
|
"object_id", |
|
"subject", |
|
"message", |
|
"link", |
|
"actions" |
|
], |
|
"properties": { |
|
"notification_id": { |
|
"type": "integer" |
|
}, |
|
"app": { |
|
"type": "string" |
|
}, |
|
"user": { |
|
"type": "string" |
|
}, |
|
"datetime": { |
|
"type": "string" |
|
}, |
|
"object_type": { |
|
"type": "string" |
|
}, |
|
"object_id": { |
|
"type": "string" |
|
}, |
|
"subject": { |
|
"type": "string" |
|
}, |
|
"message": { |
|
"type": "string" |
|
}, |
|
"link": { |
|
"type": "string" |
|
}, |
|
"subjectRich": { |
|
"type": "string" |
|
}, |
|
"subjectRichParameters": { |
|
"type": "object" |
|
}, |
|
"messageRich": { |
|
"type": "string" |
|
}, |
|
"messageRichParameters": { |
|
"type": "object" |
|
}, |
|
"icon": { |
|
"type": "string" |
|
}, |
|
"shouldNotify": { |
|
"type": "boolean" |
|
}, |
|
"actions": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NotificationsNotificationAction" |
|
} |
|
} |
|
} |
|
}, |
|
"NotificationsNotificationAction": { |
|
"type": "object", |
|
"required": [ |
|
"label", |
|
"link", |
|
"type" |
|
], |
|
"properties": { |
|
"label": { |
|
"type": "string" |
|
}, |
|
"link": { |
|
"type": "string" |
|
}, |
|
"type": { |
|
"type": "string" |
|
}, |
|
"primary": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"NotificationsListNotifications": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NotificationsNotification" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"NotificationsGetNotification": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"$ref": "#/components/schemas/NotificationsNotification" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"NotificationsPushServerSubscription": { |
|
"type": "object", |
|
"required": [ |
|
"publicKey", |
|
"deviceIdentifier", |
|
"signature" |
|
], |
|
"properties": { |
|
"publicKey": { |
|
"type": "string" |
|
}, |
|
"deviceIdentifier": { |
|
"type": "string" |
|
}, |
|
"signature": { |
|
"type": "string" |
|
}, |
|
"message": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"NotificationsPushServerRegistration": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"$ref": "#/components/schemas/NotificationsPushServerSubscription" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"NotificationsNotificationDecryptedSubject": { |
|
"type": "object", |
|
"properties": { |
|
"nid": { |
|
"type": "integer" |
|
}, |
|
"app": { |
|
"type": "string" |
|
}, |
|
"subject": { |
|
"type": "string" |
|
}, |
|
"type": { |
|
"type": "string" |
|
}, |
|
"id": { |
|
"type": "string" |
|
}, |
|
"delete": { |
|
"type": "boolean" |
|
}, |
|
"delete-all": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"ProvisioningApiUser": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"$ref": "#/components/schemas/ProvisioningApiUserDetails" |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"ProvisioningApiUserDetails": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"lastLogin", |
|
"backend", |
|
"subadmin", |
|
"quota", |
|
"avatarScope", |
|
"emailScope", |
|
"additional_mail", |
|
"additional_mailScope", |
|
"displaynameScope", |
|
"phone", |
|
"phoneScope", |
|
"address", |
|
"addressScope", |
|
"website", |
|
"websiteScope", |
|
"twitter", |
|
"twitterScope", |
|
"organisation", |
|
"organisationScope", |
|
"role", |
|
"roleScope", |
|
"headline", |
|
"headlineScope", |
|
"biography", |
|
"biographyScope", |
|
"profile_enabled", |
|
"profile_enabledScope", |
|
"fediverse", |
|
"fediverseScope", |
|
"groups", |
|
"language", |
|
"locale", |
|
"backendCapabilities" |
|
], |
|
"properties": { |
|
"enabled": { |
|
"type": "boolean" |
|
}, |
|
"storageLocation": { |
|
"type": "string" |
|
}, |
|
"id": { |
|
"type": "string" |
|
}, |
|
"lastLogin": { |
|
"type": "integer" |
|
}, |
|
"backend": { |
|
"type": "string" |
|
}, |
|
"subadmin": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"quota": { |
|
"type": "object", |
|
"required": [ |
|
"free", |
|
"used", |
|
"total", |
|
"relative", |
|
"quota" |
|
], |
|
"properties": { |
|
"free": { |
|
"type": "integer" |
|
}, |
|
"used": { |
|
"type": "integer" |
|
}, |
|
"total": { |
|
"type": "integer" |
|
}, |
|
"relative": { |
|
"type": "number" |
|
}, |
|
"quota": { |
|
"type": "integer" |
|
} |
|
} |
|
}, |
|
"avatarScope": { |
|
"type": "string" |
|
}, |
|
"email": { |
|
"type": "string" |
|
}, |
|
"emailScope": { |
|
"type": "string" |
|
}, |
|
"additional_mail": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"additional_mailScope": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"displayname": { |
|
"type": "string" |
|
}, |
|
"displaynameScope": { |
|
"type": "string" |
|
}, |
|
"phone": { |
|
"type": "string" |
|
}, |
|
"phoneScope": { |
|
"type": "string" |
|
}, |
|
"address": { |
|
"type": "string" |
|
}, |
|
"addressScope": { |
|
"type": "string" |
|
}, |
|
"website": { |
|
"type": "string" |
|
}, |
|
"websiteScope": { |
|
"type": "string" |
|
}, |
|
"twitter": { |
|
"type": "string" |
|
}, |
|
"twitterScope": { |
|
"type": "string" |
|
}, |
|
"organisation": { |
|
"type": "string" |
|
}, |
|
"organisationScope": { |
|
"type": "string" |
|
}, |
|
"role": { |
|
"type": "string" |
|
}, |
|
"roleScope": { |
|
"type": "string" |
|
}, |
|
"headline": { |
|
"type": "string" |
|
}, |
|
"headlineScope": { |
|
"type": "string" |
|
}, |
|
"biography": { |
|
"type": "string" |
|
}, |
|
"biographyScope": { |
|
"type": "string" |
|
}, |
|
"profile_enabled": { |
|
"type": "string" |
|
}, |
|
"profile_enabledScope": { |
|
"type": "string" |
|
}, |
|
"fediverse": { |
|
"type": "string" |
|
}, |
|
"fediverseScope": { |
|
"type": "string" |
|
}, |
|
"groups": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
}, |
|
"language": { |
|
"type": "string" |
|
}, |
|
"locale": { |
|
"type": "string" |
|
}, |
|
"notify_email": { |
|
"type": "string" |
|
}, |
|
"backendCapabilities": { |
|
"type": "object", |
|
"required": [ |
|
"setDisplayName", |
|
"setPassword" |
|
], |
|
"properties": { |
|
"setDisplayName": { |
|
"type": "boolean" |
|
}, |
|
"setPassword": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"display-name": { |
|
"type": "string" |
|
} |
|
} |
|
}, |
|
"UserStatusPredefinedStatuses": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/UserStatusPredefinedStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"UserStatusPredefinedStatus": { |
|
"type": "object", |
|
"required": [ |
|
"id", |
|
"icon", |
|
"message" |
|
], |
|
"properties": { |
|
"id": { |
|
"type": "string" |
|
}, |
|
"icon": { |
|
"type": "string" |
|
}, |
|
"message": { |
|
"type": "string" |
|
}, |
|
"clearAt": { |
|
"oneOf": [ |
|
{ |
|
"$ref": "#/components/schemas/UserStatusClearAt" |
|
}, |
|
{ |
|
"type": "integer", |
|
"description": "Time as unix timestamp" |
|
} |
|
] |
|
} |
|
} |
|
}, |
|
"UserStatusClearAt": { |
|
"type": "object", |
|
"required": [ |
|
"type", |
|
"time" |
|
], |
|
"properties": { |
|
"type": { |
|
"type": "string", |
|
"enum": [ |
|
"period", |
|
"end-of" |
|
] |
|
}, |
|
"time": { |
|
"oneOf": [ |
|
{ |
|
"type": "string", |
|
"enum": [ |
|
"day", |
|
"week" |
|
] |
|
}, |
|
{ |
|
"type": "integer", |
|
"description": "Time offset in seconds" |
|
} |
|
] |
|
} |
|
} |
|
}, |
|
"UserStatusType": { |
|
"type": "string", |
|
"enum": [ |
|
"online", |
|
"offline", |
|
"dnd", |
|
"away", |
|
"invisible" |
|
] |
|
}, |
|
"UserStatusGetStatus": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"oneOf": [ |
|
{ |
|
"type": "array", |
|
"items": { |
|
"type": "object" |
|
} |
|
}, |
|
{ |
|
"$ref": "#/components/schemas/UserStatusStatus" |
|
} |
|
] |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"UserStatusGetPublicStatuses": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/UserStatusPublicStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"UserStatusGetPublicStatus": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"oneOf": [ |
|
{ |
|
"type": "array", |
|
"items": { |
|
"type": "object" |
|
} |
|
}, |
|
{ |
|
"$ref": "#/components/schemas/UserStatusPublicStatus" |
|
} |
|
] |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"UserStatusStatus": { |
|
"type": "object", |
|
"required": [ |
|
"userId", |
|
"messageIsPredefined", |
|
"status", |
|
"statusIsUserDefined" |
|
], |
|
"properties": { |
|
"userId": { |
|
"type": "string" |
|
}, |
|
"message": { |
|
"type": "string" |
|
}, |
|
"messageId": { |
|
"type": "string" |
|
}, |
|
"messageIsPredefined": { |
|
"type": "boolean" |
|
}, |
|
"icon": { |
|
"type": "string" |
|
}, |
|
"clearAt": { |
|
"oneOf": [ |
|
{ |
|
"$ref": "#/components/schemas/UserStatusClearAt" |
|
}, |
|
{ |
|
"type": "integer", |
|
"description": "Time as unix timestamp" |
|
} |
|
] |
|
}, |
|
"status": { |
|
"$ref": "#/components/schemas/UserStatusType" |
|
}, |
|
"statusIsUserDefined": { |
|
"type": "boolean" |
|
} |
|
} |
|
}, |
|
"UserStatusPublicStatus": { |
|
"type": "object", |
|
"required": [ |
|
"userId", |
|
"status" |
|
], |
|
"properties": { |
|
"userId": { |
|
"type": "string" |
|
}, |
|
"message": { |
|
"type": "string" |
|
}, |
|
"icon": { |
|
"type": "string" |
|
}, |
|
"clearAt": { |
|
"oneOf": [ |
|
{ |
|
"$ref": "#/components/schemas/UserStatusClearAt" |
|
}, |
|
{ |
|
"type": "integer", |
|
"description": "Time as unix timestamp" |
|
} |
|
] |
|
}, |
|
"status": { |
|
"$ref": "#/components/schemas/UserStatusType" |
|
} |
|
} |
|
}, |
|
"UserStatusHeartbeat": { |
|
"type": "object", |
|
"required": [ |
|
"ocs" |
|
], |
|
"properties": { |
|
"ocs": { |
|
"type": "object", |
|
"required": [ |
|
"meta", |
|
"data" |
|
], |
|
"properties": { |
|
"meta": { |
|
"$ref": "#/components/schemas/OCSMeta" |
|
}, |
|
"data": { |
|
"$ref": "#/components/schemas/UserStatusStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"securitySchemes": { |
|
"basic_auth": { |
|
"type": "http", |
|
"scheme": "basic" |
|
} |
|
} |
|
}, |
|
"paths": { |
|
"/status.php": { |
|
"get": { |
|
"operationId": "get-status", |
|
"tags": [ |
|
"core" |
|
], |
|
"security": [], |
|
"responses": { |
|
"200": { |
|
"description": "Status of the Nextcloud instance", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/CoreServerStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/cloud/capabilities": { |
|
"get": { |
|
"operationId": "get-capabilities", |
|
"tags": [ |
|
"core" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "Capabilities of the Nextcloud instance", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/CoreServerCapabilities" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/core/navigation/apps": { |
|
"get": { |
|
"operationId": "get-navigation-apps", |
|
"tags": [ |
|
"core" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "Navigation apps of the Nextcloud instance", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/CoreNavigationApps" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/login/v2": { |
|
"post": { |
|
"operationId": "init-login-flow", |
|
"tags": [ |
|
"core" |
|
], |
|
"security": [], |
|
"responses": { |
|
"200": { |
|
"description": "Login flow init", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/CoreLoginFlowInit" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/login/v2/poll": { |
|
"post": { |
|
"operationId": "get-login-flow-result", |
|
"tags": [ |
|
"core" |
|
], |
|
"security": [], |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "Login flow result", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/CoreLoginFlowResult" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/core/preview.png": { |
|
"parameters": [ |
|
{ |
|
"name": "file", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
}, |
|
{ |
|
"name": "x", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 32 |
|
} |
|
}, |
|
{ |
|
"name": "y", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 32 |
|
} |
|
}, |
|
{ |
|
"name": "a", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "forceIcon", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 1 |
|
} |
|
}, |
|
{ |
|
"name": "mode", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "fill" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-preview", |
|
"tags": [ |
|
"core" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "Preview image of a file", |
|
"content": { |
|
"image/png": { |
|
"schema": { |
|
"type": "string", |
|
"format": "binary" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/avatar/{userId}/{size}/dark": { |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "size", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-dark-avatar", |
|
"tags": [ |
|
"core" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"image/png": { |
|
"schema": { |
|
"type": "string", |
|
"format": "binary" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/avatar/{userId}/{size}": { |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "size", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-avatar", |
|
"tags": [ |
|
"core" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"image/png": { |
|
"schema": { |
|
"type": "string", |
|
"format": "binary" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/core/autocomplete/get": { |
|
"get": { |
|
"operationId": "autocomplete", |
|
"tags": [ |
|
"core" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "search", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "itemType", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "itemId", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "sorter", |
|
"in": "query", |
|
"description": "can be piped, top prio first, e.g.: \"commenters|share-recipients\"", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "shareTypes", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "array", |
|
"items": { |
|
"type": "integer" |
|
} |
|
} |
|
}, |
|
{ |
|
"name": "limit", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 10 |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/CoreAutocompleteResult" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/core/apppassword": { |
|
"delete": { |
|
"tags": [ |
|
"core" |
|
], |
|
"operationId": "delete-app-password", |
|
"responses": { |
|
"200": { |
|
"description": "App password deleted successfully", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"type": "object" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api": { |
|
"get": { |
|
"operationId": "get-supported-api-versions", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsSupportedAPIVersions" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/folders": { |
|
"get": { |
|
"operationId": "list-folders", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsListFolders" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"post": { |
|
"operationId": "create-folder", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsListFolders" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/folders/{folderId}": { |
|
"parameters": [ |
|
{ |
|
"name": "folderId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"put": { |
|
"operationId": "rename-folder", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "name", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
}, |
|
"delete": { |
|
"operationId": "delete-folder", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/folders/{folderId}/read": { |
|
"parameters": [ |
|
{ |
|
"name": "folderId", |
|
"in": "path", |
|
"description": "ID of the folder", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "mark-folder-as-read", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "newestItemId", |
|
"in": "query", |
|
"description": "The newest read item", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/feeds": { |
|
"get": { |
|
"operationId": "list-feeds", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsListFeeds" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"post": { |
|
"operationId": "add-feed", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "url", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "folderId", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsListFeeds" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/feeds/{feedId}": { |
|
"parameters": [ |
|
{ |
|
"name": "feedId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"delete": { |
|
"operationId": "delete-feed", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/feeds/{feedId}/move": { |
|
"parameters": [ |
|
{ |
|
"name": "feedId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "move-feed", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "folderId", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/feeds/{feedId}/rename": { |
|
"parameters": [ |
|
{ |
|
"name": "feedId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "rename-feed", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "feedTitle", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/feeds/{feedId}/read": { |
|
"parameters": [ |
|
{ |
|
"name": "feedId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "mark-feed-as-read", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "newestItemId", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/items": { |
|
"get": { |
|
"operationId": "list-articles", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "type", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 3 |
|
} |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "getRead", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 1 |
|
} |
|
}, |
|
{ |
|
"name": "batchSize", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": -1 |
|
} |
|
}, |
|
{ |
|
"name": "offset", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "oldestFirst", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsListArticles" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/items/updated": { |
|
"get": { |
|
"operationId": "list-updated-articles", |
|
"tags": [ |
|
"news" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "type", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 3 |
|
} |
|
}, |
|
{ |
|
"name": "id", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "lastModified", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NewsListArticles" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/items/{itemId}/read": { |
|
"parameters": [ |
|
{ |
|
"name": "itemId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "mark-article-as-read", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/items/{itemId}/unread": { |
|
"parameters": [ |
|
{ |
|
"name": "itemId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "mark-article-as-unread", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/items/{itemId}/star": { |
|
"parameters": [ |
|
{ |
|
"name": "itemId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "star-article", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/news/api/v1-3/items/{itemId}/unstar": { |
|
"parameters": [ |
|
{ |
|
"name": "itemId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "unstar-article", |
|
"tags": [ |
|
"news" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/notes/api/v1/notes": { |
|
"get": { |
|
"operationId": "get-notes", |
|
"tags": [ |
|
"notes" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "category", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "exclude", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
}, |
|
{ |
|
"name": "pruneBefore", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "chunkSize", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "chunkCursor", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "If-None-Match", |
|
"in": "header", |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"type": "array", |
|
"items": { |
|
"$ref": "#/components/schemas/NotesNote" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"post": { |
|
"operationId": "create-note", |
|
"tags": [ |
|
"notes" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "category", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
}, |
|
{ |
|
"name": "title", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
}, |
|
{ |
|
"name": "content", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
}, |
|
{ |
|
"name": "modified", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "favorite", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotesNote" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/notes/api/v1/notes/{id}": { |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-note", |
|
"tags": [ |
|
"notes" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "exclude", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
}, |
|
{ |
|
"name": "If-None-Match", |
|
"in": "header", |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotesNote" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"put": { |
|
"operationId": "update-note", |
|
"tags": [ |
|
"notes" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "content", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "modified", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
}, |
|
{ |
|
"name": "title", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "category", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "favorite", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer", |
|
"default": 0 |
|
} |
|
}, |
|
{ |
|
"name": "If-Match", |
|
"in": "header", |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotesNote" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"delete": { |
|
"operationId": "delete-note", |
|
"tags": [ |
|
"notes" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/notes/api/v1/settings": { |
|
"get": { |
|
"operationId": "get-settings", |
|
"tags": [ |
|
"notes" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotesSettings" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"put": { |
|
"operationId": "update-settings", |
|
"tags": [ |
|
"notes" |
|
], |
|
"requestBody": { |
|
"required": true, |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotesSettings" |
|
} |
|
} |
|
} |
|
}, |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotesSettings" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/notifications/api/v2/notifications": { |
|
"get": { |
|
"operationId": "list-notifications", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotificationsListNotifications" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"delete": { |
|
"operationId": "delete-all-notifications", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/notifications/api/v2/notifications/{id}": { |
|
"parameters": [ |
|
{ |
|
"name": "id", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-notification", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotificationsGetNotification" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"delete": { |
|
"operationId": "delete-notification", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/EmptyOCS" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/notifications/api/v2/push": { |
|
"post": { |
|
"operationId": "register-device", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "pushTokenHash", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "devicePublicKey", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "proxyServer", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
}, |
|
"description": "This URL has to end with a / otherwise the device will not be able to register" |
|
} |
|
], |
|
"responses": { |
|
"201": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/NotificationsPushServerRegistration" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"delete": { |
|
"operationId": "remove-device", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"responses": { |
|
"202": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/notifications/api/v2/admin_notifications/{userId}": { |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"post": { |
|
"operationId": "send-admin-notification", |
|
"tags": [ |
|
"notifications" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "shortMessage", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "longMessage", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string", |
|
"default": "" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/EmptyOCS" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/cloud/user": { |
|
"get": { |
|
"operationId": "get-current-user", |
|
"tags": [ |
|
"provisioning_api" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/ProvisioningApiUser" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/cloud/users/{userId}": { |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-user", |
|
"tags": [ |
|
"provisioning_api" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/ProvisioningApiUser" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush": { |
|
"get": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Check if the UnifiedPush provider is present", |
|
"operationId": "unified_push_provider-check", |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/keepalive": { |
|
"put": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Set keepalive interval", |
|
"description": "This endpoint requires admin access", |
|
"operationId": "unified_push_provider-set-keepalive", |
|
"parameters": [ |
|
{ |
|
"name": "keepalive", |
|
"in": "query", |
|
"description": "Keep alive value in seconds", |
|
"required": true, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/device": { |
|
"put": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Request to create a new deviceId", |
|
"operationId": "unified_push_provider-create-device", |
|
"parameters": [ |
|
{ |
|
"name": "deviceName", |
|
"in": "query", |
|
"description": "Name of the device", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success", |
|
"deviceId" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
}, |
|
"deviceId": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/device/{deviceId}": { |
|
"parameters": [ |
|
{ |
|
"name": "deviceId", |
|
"in": "path", |
|
"description": "ID of the device", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"get": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Request to get push messages", |
|
"description": "This is a public page since it has to be handle by the non-connected app (NextPush app and not Nextcloud-app)", |
|
"operationId": "unified_push_provider-sync-device", |
|
"responses": { |
|
"401": { |
|
"description": "Missing permissions to sync device", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"delete": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Delete a device", |
|
"operationId": "unified_push_provider-delete-device", |
|
"responses": { |
|
"200": { |
|
"description": "Device deleted successfully", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/app": { |
|
"put": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Create an authorization token for a new 3rd party service", |
|
"operationId": "unified_push_provider-create-app", |
|
"parameters": [ |
|
{ |
|
"name": "deviceId", |
|
"in": "query", |
|
"description": "ID of the device", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "appName", |
|
"in": "query", |
|
"description": "Name of the app", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "App created successfully", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success", |
|
"token" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
}, |
|
"token": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/app/{token}": { |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "path", |
|
"description": "Token of the app", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"delete": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Delete an authorization token", |
|
"operationId": "unified_push_provider-delete-app", |
|
"responses": { |
|
"200": { |
|
"description": "App deleted successfully", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/push/{token}": { |
|
"parameters": [ |
|
{ |
|
"name": "token", |
|
"in": "path", |
|
"description": "Token of the app to push to", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"post": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Receive notifications from 3rd parties", |
|
"operationId": "unified_push_provider-push", |
|
"responses": { |
|
"201": { |
|
"description": "Notification pushed successfully", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"success" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"success": { |
|
"type": "boolean" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"get": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Unifiedpush discovery Following specifications", |
|
"operationId": "unified_push_provider-unifiedpush-discovery", |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"unifiedpush" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"unifiedpush": { |
|
"required": [ |
|
"version" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"version": { |
|
"type": "integer" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/index.php/apps/uppush/gateway/matrix": { |
|
"get": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Matrix Gateway discovery", |
|
"operationId": "unified_push_provider-gateway-matrix-discovery", |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"unifiedpush" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"unifiedpush": { |
|
"required": [ |
|
"gateway" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"gateway": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"post": { |
|
"tags": [ |
|
"unified_push_provider" |
|
], |
|
"summary": "Matrix Gateway", |
|
"operationId": "unified_push_provider-gateway-matrix", |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"required": [ |
|
"rejected" |
|
], |
|
"type": "object", |
|
"properties": { |
|
"rejected": { |
|
"type": "array", |
|
"items": { |
|
"type": "string" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/statuses": { |
|
"get": { |
|
"operationId": "get-public-statuses", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusGetPublicStatuses" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/statuses/{userId}": { |
|
"parameters": [ |
|
{ |
|
"name": "userId", |
|
"in": "path", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
} |
|
], |
|
"get": { |
|
"operationId": "get-public-status", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusGetPublicStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/user_status": { |
|
"get": { |
|
"operationId": "get-status", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusGetStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/user_status/status": { |
|
"put": { |
|
"operationId": "set-status", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "statusType", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusType" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusGetStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/user_status/message/predefined": { |
|
"put": { |
|
"operationId": "set-predefined-message", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "messageId", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "clearAt", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusGetStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/user_status/message/custom": { |
|
"put": { |
|
"operationId": "set-custom-message", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "statusIcon", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "message", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "string" |
|
} |
|
}, |
|
{ |
|
"name": "clearAt", |
|
"in": "query", |
|
"required": false, |
|
"schema": { |
|
"type": "integer" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusGetStatus" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/user_status/message": { |
|
"delete": { |
|
"operationId": "clear-message", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "" |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/predefined_statuses": { |
|
"get": { |
|
"operationId": "get-predefined-statuses", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusPredefinedStatuses" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}, |
|
"/ocs/v2.php/apps/user_status/api/v1/heartbeat": { |
|
"put": { |
|
"operationId": "heartbeat", |
|
"tags": [ |
|
"user_status" |
|
], |
|
"parameters": [ |
|
{ |
|
"name": "status", |
|
"in": "query", |
|
"required": true, |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusType" |
|
} |
|
} |
|
], |
|
"responses": { |
|
"200": { |
|
"description": "", |
|
"content": { |
|
"application/json": { |
|
"schema": { |
|
"$ref": "#/components/schemas/UserStatusHeartbeat" |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
} |
|
}
|
|
|