A framework for building convergent cross-platform Nextcloud clients using Flutter.
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.
 
 

3713 lines
94 KiB

{
"openapi": "3.1.0",
"info": {
"title": "Nextcloud",
"version": "25.0.4",
"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": [
{
"name": "core"
},
{
"name": "news"
},
{
"name": "notes"
},
{
"name": "notifications"
},
{
"name": "provisioning_api"
},
{
"name": "user_status"
}
],
"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": {
"anyOf": [
{
"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",
"faviconLink",
"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"
]
}
}
},
"NotificationsNotification": {
"type": "object",
"required": [
"notification_id",
"app",
"user",
"datetime",
"object_type",
"object_id",
"subject",
"message",
"link",
"subjectRich",
"subjectRichParameters",
"messageRich",
"messageRichParameters",
"icon",
"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": {
"anyOf": [
{
"type": "object",
"properties": {}
}
]
},
"messageRich": {
"type": "string"
},
"messageRichParameters": {
"anyOf": [
{
"type": "object",
"properties": {}
}
]
},
"icon": {
"type": "string"
},
"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"
}
}
}
}
},
"NotificationsPushNotification": {
"type": "object",
"required": [
"accountID",
"priority",
"type",
"subject"
],
"properties": {
"accountID": {
"type": "string"
},
"priority": {
"type": "string"
},
"type": {
"type": "string"
},
"subject": {
"$ref": "#/components/schemas/NotificationsPushNotificationDecryptedSubject"
}
}
},
"NotificationsPushNotificationDecryptedSubject": {
"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",
"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"
},
"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",
"clearAt"
],
"properties": {
"id": {
"type": "string"
},
"icon": {
"type": "string"
},
"message": {
"type": "string"
},
"clearAt": {
"anyOf": [
{
"$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": {
"anyOf": [
{
"$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": {
"anyOf": [
{
"$ref": "#/components/schemas/UserStatusPublicStatus"
}
]
}
}
}
}
},
"UserStatusStatus": {
"type": "object",
"required": [
"userId",
"messageIsPredefined",
"clearAt",
"status",
"statusIsUserDefined"
],
"properties": {
"userId": {
"type": "string"
},
"message": {
"type": "string"
},
"messageId": {
"type": "string"
},
"messageIsPredefined": {
"type": "boolean"
},
"icon": {
"type": "string"
},
"clearAt": {
"anyOf": [
{
"$ref": "#/components/schemas/UserStatusClearAt"
},
{
"type": "integer",
"description": "Time as unix timestamp"
}
]
},
"status": {
"$ref": "#/components/schemas/UserStatusType"
},
"statusIsUserDefined": {
"type": "boolean"
}
}
},
"UserStatusPublicStatus": {
"type": "object",
"required": [
"userId",
"clearAt",
"status"
],
"properties": {
"userId": {
"type": "string"
},
"message": {
"type": "string"
},
"icon": {
"type": "string"
},
"clearAt": {
"anyOf": [
{
"$ref": "#/components/schemas/UserStatusClearAt"
},
{
"type": "integer",
"description": "Time as unix timestamp"
}
]
},
"status": {
"$ref": "#/components/schemas/UserStatusType"
}
}
}
},
"securitySchemes": {
"basic_auth": {
"type": "http",
"scheme": "basic"
}
}
},
"paths": {
"/status.php": {
"get": {
"operationId": "get-status",
"tags": [
"core"
],
"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"
],
"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"
],
"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"
}
}
}
}
}
}
},
"/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"
}
}
}
}
}
}
},
"/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/UserStatusStatus"
}
}
}
}
}
}
}
}
}