2023-05-24 10:34:27 -04:00
{
"openapi" : "3.0.3" ,
"info" : {
"title" : "core" ,
"version" : "0.0.1" ,
"description" : "Core functionality of Nextcloud" ,
"license" : {
"name" : "agpl"
}
} ,
"components" : {
"securitySchemes" : {
"basic_auth" : {
"type" : "http" ,
"scheme" : "basic"
} ,
"bearer_auth" : {
"type" : "http" ,
"scheme" : "bearer"
}
} ,
"schemas" : {
"AutocompleteResult" : {
"type" : "object" ,
"required" : [
"id" ,
"label" ,
"icon" ,
"source" ,
"status" ,
"subline" ,
"shareWithDisplayNameUnique"
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
"label" : {
"type" : "string"
} ,
"icon" : {
"type" : "string"
} ,
"source" : {
"type" : "string"
} ,
"status" : {
2023-09-27 10:38:21 -04:00
"oneOf" : [
{
"type" : "object" ,
"required" : [
"status" ,
"message" ,
"icon" ,
"clearAt"
] ,
"properties" : {
"status" : {
"type" : "string"
} ,
"message" : {
"type" : "string" ,
"nullable" : true
} ,
"icon" : {
"type" : "string" ,
"nullable" : true
} ,
"clearAt" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
}
}
} ,
{
"type" : "string"
}
]
2023-05-24 10:34:27 -04:00
} ,
"subline" : {
"type" : "string"
} ,
"shareWithDisplayNameUnique" : {
"type" : "string"
}
}
} ,
2024-04-08 14:09:24 -04:00
"Capabilities" : {
"type" : "object" ,
"required" : [
"core"
] ,
"properties" : {
"core" : {
"type" : "object" ,
"required" : [
"pollinterval" ,
"webdav-root" ,
"reference-api" ,
2024-04-12 06:55:59 -04:00
"reference-regex" ,
2025-08-18 06:46:00 -04:00
"mod-rewrite-working"
2024-04-08 14:09:24 -04:00
] ,
"properties" : {
"pollinterval" : {
"type" : "integer" ,
"format" : "int64"
} ,
"webdav-root" : {
"type" : "string"
} ,
"reference-api" : {
"type" : "boolean"
} ,
"reference-regex" : {
"type" : "string"
2024-04-12 06:55:59 -04:00
} ,
"mod-rewrite-working" : {
"type" : "boolean"
2025-08-16 17:43:14 -04:00
} ,
"user" : {
"type" : "object" ,
"required" : [
"language" ,
"locale" ,
"timezone"
] ,
"properties" : {
"language" : {
"type" : "string"
} ,
"locale" : {
"type" : "string"
} ,
"timezone" : {
"type" : "string"
}
}
2026-01-09 12:06:06 -05:00
} ,
"can-create-app-token" : {
"type" : "boolean"
2024-04-08 14:09:24 -04:00
}
}
}
}
} ,
2023-05-24 10:34:27 -04:00
"Collection" : {
"type" : "object" ,
"required" : [
"id" ,
"name" ,
"resources"
] ,
"properties" : {
"id" : {
2023-03-15 12:29:32 -04:00
"type" : "integer" ,
"format" : "int64"
2023-05-24 10:34:27 -04:00
} ,
"name" : {
"type" : "string"
} ,
"resources" : {
"type" : "array" ,
"items" : {
2023-09-14 06:26:14 -04:00
"$ref" : "#/components/schemas/Resource"
2023-05-24 10:34:27 -04:00
}
}
}
} ,
"ContactsAction" : {
"type" : "object" ,
"required" : [
"title" ,
"icon" ,
"hyperlink" ,
"appId"
] ,
"properties" : {
"title" : {
"type" : "string"
} ,
"icon" : {
"type" : "string"
} ,
"hyperlink" : {
"type" : "string"
} ,
"appId" : {
"type" : "string"
}
}
} ,
"LoginFlowV2" : {
"type" : "object" ,
"required" : [
"poll" ,
"login"
] ,
"properties" : {
"poll" : {
"type" : "object" ,
"required" : [
"token" ,
"endpoint"
] ,
"properties" : {
"token" : {
"type" : "string"
} ,
"endpoint" : {
"type" : "string"
}
}
} ,
"login" : {
"type" : "string"
}
}
} ,
"LoginFlowV2Credentials" : {
"type" : "object" ,
"required" : [
"server" ,
"loginName" ,
"appPassword"
] ,
"properties" : {
"server" : {
"type" : "string"
} ,
"loginName" : {
"type" : "string"
} ,
"appPassword" : {
"type" : "string"
}
}
} ,
"NavigationEntry" : {
"type" : "object" ,
"required" : [
"id" ,
"href" ,
"icon" ,
"type" ,
"name" ,
"active" ,
"classes" ,
"unread"
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
"order" : {
2024-05-30 10:59:04 -04:00
"type" : "integer" ,
"format" : "int64"
2023-05-24 10:34:27 -04:00
} ,
"href" : {
"type" : "string"
} ,
"icon" : {
"type" : "string"
} ,
"type" : {
"type" : "string"
} ,
"name" : {
"type" : "string"
} ,
2024-05-22 10:21:12 -04:00
"app" : {
"type" : "string"
} ,
"default" : {
"type" : "boolean"
} ,
2023-05-24 10:34:27 -04:00
"active" : {
"type" : "boolean"
} ,
"classes" : {
"type" : "string"
} ,
"unread" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
"OCSMeta" : {
"type" : "object" ,
"required" : [
"status" ,
"statuscode"
] ,
"properties" : {
"status" : {
"type" : "string"
} ,
"statuscode" : {
"type" : "integer"
} ,
"message" : {
"type" : "string"
} ,
"totalitems" : {
"type" : "string"
} ,
"itemsperpage" : {
"type" : "string"
}
}
} ,
2023-03-15 12:29:32 -04:00
"OpenGraphObject" : {
2023-05-24 10:34:27 -04:00
"type" : "object" ,
"required" : [
2023-09-14 06:26:14 -04:00
"id" ,
"name" ,
"description" ,
"thumb" ,
"link"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2023-09-14 06:26:14 -04:00
"id" : {
2023-05-24 10:34:27 -04:00
"type" : "string"
} ,
2023-09-14 06:26:14 -04:00
"name" : {
"type" : "string"
2023-05-24 10:34:27 -04:00
} ,
2023-09-14 06:26:14 -04:00
"description" : {
"type" : "string" ,
"nullable" : true
2023-05-24 10:34:27 -04:00
} ,
2023-09-14 06:26:14 -04:00
"thumb" : {
"type" : "string" ,
"nullable" : true
} ,
"link" : {
"type" : "string"
2023-05-24 10:34:27 -04:00
}
}
} ,
2025-04-23 04:16:06 -04:00
"ProfileAction" : {
"type" : "object" ,
"required" : [
"id" ,
"icon" ,
"title" ,
"target"
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
"icon" : {
"type" : "string"
} ,
"title" : {
"type" : "string"
} ,
"target" : {
"type" : "string" ,
"nullable" : true
}
}
} ,
"ProfileData" : {
"allOf" : [
{
"$ref" : "#/components/schemas/ProfileFields"
} ,
{
"type" : "object" ,
"required" : [
"timezone" ,
"timezoneOffset"
] ,
"properties" : {
"timezone" : {
"type" : "string" ,
"description" : "Timezone identifier like Europe/Berlin or America/North_Dakota/Beulah"
} ,
"timezoneOffset" : {
"type" : "integer" ,
"format" : "int64" ,
"description" : "Offset in seconds, negative when behind UTC, positive otherwise"
}
}
}
]
} ,
"ProfileFields" : {
"type" : "object" ,
"required" : [
"userId" ,
"actions"
] ,
"properties" : {
"userId" : {
"type" : "string"
} ,
"address" : {
"type" : "string" ,
"nullable" : true
} ,
"biography" : {
"type" : "string" ,
"nullable" : true
} ,
"displayname" : {
"type" : "string" ,
"nullable" : true
} ,
"headline" : {
"type" : "string" ,
"nullable" : true
} ,
"isUserAvatarVisible" : {
"type" : "boolean"
} ,
"organisation" : {
"type" : "string" ,
"nullable" : true
} ,
"pronouns" : {
"type" : "string" ,
"nullable" : true
} ,
"role" : {
"type" : "string" ,
"nullable" : true
} ,
"actions" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/ProfileAction"
}
}
}
} ,
2024-04-08 14:09:24 -04:00
"PublicCapabilities" : {
"type" : "object" ,
"required" : [
"bruteforce"
] ,
"properties" : {
"bruteforce" : {
"type" : "object" ,
"required" : [
"delay" ,
"allow-listed"
] ,
"properties" : {
"delay" : {
"type" : "integer" ,
"format" : "int64"
} ,
"allow-listed" : {
"type" : "boolean"
}
}
}
}
} ,
2023-03-15 12:29:32 -04:00
"Reference" : {
"type" : "object" ,
"required" : [
"richObjectType" ,
"richObject" ,
"openGraphObject" ,
"accessible"
] ,
"properties" : {
"richObjectType" : {
"type" : "string"
} ,
"richObject" : {
"type" : "object" ,
"additionalProperties" : {
2024-06-02 17:41:06 -04:00
"type" : "object" ,
"nullable" : true
2023-03-15 12:29:32 -04:00
}
} ,
"openGraphObject" : {
"$ref" : "#/components/schemas/OpenGraphObject"
} ,
"accessible" : {
"type" : "boolean"
}
}
} ,
2023-05-24 10:34:27 -04:00
"ReferenceProvider" : {
"type" : "object" ,
"required" : [
"id" ,
"title" ,
"icon_url" ,
"order" ,
"search_providers_ids"
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
"title" : {
"type" : "string"
} ,
"icon_url" : {
"type" : "string"
} ,
"order" : {
"type" : "integer" ,
"format" : "int64"
} ,
"search_providers_ids" : {
"type" : "array" ,
"nullable" : true ,
"items" : {
"type" : "string"
}
}
}
} ,
2023-09-14 06:26:14 -04:00
"Resource" : {
"type" : "object" ,
"required" : [
"richObjectType" ,
"richObject" ,
"openGraphObject" ,
"accessible"
] ,
"properties" : {
"richObjectType" : {
"type" : "string"
} ,
"richObject" : {
"type" : "object" ,
"additionalProperties" : {
2024-06-02 17:41:06 -04:00
"type" : "object" ,
"nullable" : true
2023-09-14 06:26:14 -04:00
}
} ,
"openGraphObject" : {
"$ref" : "#/components/schemas/OpenGraphObject"
} ,
"accessible" : {
"type" : "boolean"
}
}
} ,
2023-05-24 10:34:27 -04:00
"Status" : {
"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"
}
}
} ,
2024-05-14 04:01:09 -04:00
"TaskProcessingIO" : {
"type" : "object" ,
"additionalProperties" : {
"anyOf" : [
{
"type" : "number"
} ,
{
"type" : "array" ,
"items" : {
"type" : "number"
}
} ,
{
"type" : "string"
} ,
{
"type" : "array" ,
"items" : {
"type" : "string"
}
}
]
}
} ,
2024-05-02 05:46:49 -04:00
"TaskProcessingShape" : {
"type" : "object" ,
"required" : [
"name" ,
"description" ,
2024-07-24 10:01:01 -04:00
"type"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"description" : {
"type" : "string"
} ,
"type" : {
2024-05-14 04:01:09 -04:00
"type" : "string" ,
"enum" : [
"Number" ,
"Text" ,
"Audio" ,
"Image" ,
"Video" ,
"File" ,
2024-07-24 10:01:01 -04:00
"Enum" ,
2024-05-14 04:01:09 -04:00
"ListOfNumbers" ,
"ListOfTexts" ,
"ListOfImages" ,
"ListOfAudios" ,
"ListOfVideos" ,
"ListOfFiles"
]
2024-05-02 05:46:49 -04:00
}
}
} ,
"TaskProcessingTask" : {
"type" : "object" ,
"required" : [
"id" ,
2024-05-15 03:30:05 -04:00
"lastUpdated" ,
2024-05-06 03:37:46 -04:00
"type" ,
2024-05-02 05:46:49 -04:00
"status" ,
"userId" ,
"appId" ,
"input" ,
"output" ,
2024-05-07 07:04:31 -04:00
"customId" ,
2024-05-02 05:46:49 -04:00
"completionExpectedAt" ,
2024-09-24 09:53:13 -04:00
"progress" ,
"scheduledAt" ,
"startedAt" ,
2025-08-06 06:35:50 -04:00
"endedAt" ,
2025-11-26 09:48:30 -05:00
"allowCleanup" ,
2026-01-12 07:37:44 -05:00
"includeWatermark" ,
"userFacingErrorMessage"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
"id" : {
"type" : "integer" ,
2024-05-06 07:03:03 -04:00
"format" : "int64"
2024-05-02 05:46:49 -04:00
} ,
2024-05-15 03:30:05 -04:00
"lastUpdated" : {
"type" : "integer" ,
"format" : "int64"
} ,
2024-05-06 03:37:46 -04:00
"type" : {
"type" : "string"
} ,
2024-05-02 05:46:49 -04:00
"status" : {
2024-05-06 10:36:35 -04:00
"type" : "string" ,
2024-05-03 04:14:19 -04:00
"enum" : [
2024-05-06 10:36:35 -04:00
"STATUS_CANCELLED" ,
"STATUS_FAILED" ,
"STATUS_SUCCESSFUL" ,
"STATUS_RUNNING" ,
"STATUS_SCHEDULED" ,
"STATUS_UNKNOWN"
2024-05-03 04:14:19 -04:00
]
2024-05-02 05:46:49 -04:00
} ,
"userId" : {
"type" : "string" ,
"nullable" : true
} ,
"appId" : {
"type" : "string"
} ,
"input" : {
2024-05-14 04:01:09 -04:00
"$ref" : "#/components/schemas/TaskProcessingIO"
2024-05-02 05:46:49 -04:00
} ,
"output" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/TaskProcessingIO"
}
]
2024-05-02 05:46:49 -04:00
} ,
2024-05-07 07:04:31 -04:00
"customId" : {
2024-05-02 05:46:49 -04:00
"type" : "string" ,
"nullable" : true
} ,
"completionExpectedAt" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
} ,
"progress" : {
"type" : "number" ,
"format" : "double" ,
"nullable" : true
2024-09-24 09:53:13 -04:00
} ,
"scheduledAt" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
} ,
"startedAt" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
} ,
"endedAt" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
2025-08-06 06:35:50 -04:00
} ,
2025-08-07 04:57:39 -04:00
"allowCleanup" : {
2025-08-06 06:35:50 -04:00
"type" : "boolean"
2025-11-26 09:48:30 -05:00
} ,
"includeWatermark" : {
"type" : "boolean"
2026-01-12 07:37:44 -05:00
} ,
"userFacingErrorMessage" : {
"type" : "string" ,
"nullable" : true
2024-05-02 05:46:49 -04:00
}
}
} ,
"TaskProcessingTaskType" : {
"type" : "object" ,
"required" : [
"name" ,
"description" ,
"inputShape" ,
2024-07-24 10:01:01 -04:00
"inputShapeEnumValues" ,
"inputShapeDefaults" ,
"optionalInputShape" ,
"optionalInputShapeEnumValues" ,
"optionalInputShapeDefaults" ,
"outputShape" ,
"outputShapeEnumValues" ,
"optionalOutputShape" ,
"optionalOutputShapeEnumValues"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"description" : {
"type" : "string"
} ,
"inputShape" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-05-02 05:46:49 -04:00
"$ref" : "#/components/schemas/TaskProcessingShape"
}
} ,
2024-07-24 10:01:01 -04:00
"inputShapeEnumValues" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-07-24 10:01:01 -04:00
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"name" ,
"value"
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"value" : {
"type" : "string"
}
}
}
}
} ,
"inputShapeDefaults" : {
"type" : "object" ,
"additionalProperties" : {
"oneOf" : [
{
"type" : "number"
} ,
{
"type" : "string"
}
]
}
} ,
"optionalInputShape" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-07-24 10:01:01 -04:00
"$ref" : "#/components/schemas/TaskProcessingShape"
}
} ,
"optionalInputShapeEnumValues" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-07-24 10:01:01 -04:00
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"name" ,
"value"
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"value" : {
"type" : "string"
}
}
}
}
} ,
"optionalInputShapeDefaults" : {
"type" : "object" ,
"additionalProperties" : {
"oneOf" : [
{
"type" : "number"
} ,
{
"type" : "string"
}
]
}
} ,
2024-05-02 05:46:49 -04:00
"outputShape" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-05-02 05:46:49 -04:00
"$ref" : "#/components/schemas/TaskProcessingShape"
}
2024-07-24 10:01:01 -04:00
} ,
"outputShapeEnumValues" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-07-24 10:01:01 -04:00
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"name" ,
"value"
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"value" : {
"type" : "string"
}
}
}
}
} ,
"optionalOutputShape" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-07-24 10:01:01 -04:00
"$ref" : "#/components/schemas/TaskProcessingShape"
}
} ,
"optionalOutputShapeEnumValues" : {
2025-01-08 10:38:06 -05:00
"type" : "object" ,
"additionalProperties" : {
2024-07-24 10:01:01 -04:00
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"name" ,
"value"
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"value" : {
"type" : "string"
}
}
}
}
2024-05-02 05:46:49 -04:00
}
}
} ,
2024-02-26 10:30:16 -05:00
"Team" : {
"type" : "object" ,
"required" : [
2025-10-13 07:55:05 -04:00
"teamId" ,
"displayName" ,
"link"
2024-02-26 10:30:16 -05:00
] ,
"properties" : {
2025-10-13 07:55:05 -04:00
"teamId" : {
2024-02-26 10:30:16 -05:00
"type" : "string"
} ,
2025-10-13 07:55:05 -04:00
"displayName" : {
2024-02-26 10:30:16 -05:00
"type" : "string"
} ,
2025-10-13 07:55:05 -04:00
"link" : {
"type" : "string" ,
"nullable" : true
2024-02-26 10:30:16 -05:00
}
}
} ,
"TeamResource" : {
"type" : "object" ,
"required" : [
"id" ,
"label" ,
"url" ,
"iconSvg" ,
"iconURL" ,
2025-10-13 07:55:05 -04:00
"iconEmoji" ,
"provider"
2024-02-26 10:30:16 -05:00
] ,
"properties" : {
"id" : {
2025-10-13 07:55:05 -04:00
"type" : "string"
2024-02-26 10:30:16 -05:00
} ,
"label" : {
"type" : "string"
} ,
"url" : {
"type" : "string"
} ,
"iconSvg" : {
"type" : "string" ,
"nullable" : true
} ,
"iconURL" : {
"type" : "string" ,
"nullable" : true
} ,
"iconEmoji" : {
"type" : "string" ,
"nullable" : true
2025-10-13 07:55:05 -04:00
} ,
"provider" : {
"type" : "object" ,
"required" : [
"id" ,
"name" ,
"icon"
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
"name" : {
"type" : "string"
} ,
"icon" : {
"type" : "string"
}
}
2024-02-26 10:30:16 -05:00
}
}
} ,
2025-10-13 07:55:05 -04:00
"TeamWithResources" : {
"allOf" : [
{
"$ref" : "#/components/schemas/Team"
} ,
{
"type" : "object" ,
"required" : [
"resources"
] ,
"properties" : {
"resources" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/TeamResource"
}
}
}
}
]
} ,
2023-07-31 05:58:54 -04:00
"TextProcessingTask" : {
"type" : "object" ,
"required" : [
"id" ,
"type" ,
"status" ,
"userId" ,
"appId" ,
"input" ,
"output" ,
2023-11-06 08:52:59 -05:00
"identifier" ,
"completionExpectedAt"
2023-07-31 05:58:54 -04:00
] ,
"properties" : {
"id" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
} ,
"type" : {
"type" : "string"
} ,
"status" : {
2023-07-31 11:03:06 -04:00
"type" : "integer" ,
2023-12-08 05:06:05 -05:00
"format" : "int64" ,
"enum" : [
0 ,
1 ,
2 ,
3 ,
4
]
2023-07-31 05:58:54 -04:00
} ,
"userId" : {
"type" : "string" ,
"nullable" : true
} ,
"appId" : {
"type" : "string"
} ,
"input" : {
"type" : "string"
} ,
"output" : {
"type" : "string" ,
"nullable" : true
} ,
"identifier" : {
"type" : "string"
2023-11-06 08:52:59 -05:00
} ,
"completionExpectedAt" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
2023-07-31 05:58:54 -04:00
}
}
} ,
2023-10-19 05:07:03 -04:00
"TextToImageTask" : {
"type" : "object" ,
"required" : [
"id" ,
"status" ,
"userId" ,
"appId" ,
"input" ,
2023-10-20 07:33:05 -04:00
"identifier" ,
2023-10-20 07:54:36 -04:00
"numberOfImages" ,
"completionExpectedAt"
2023-10-19 05:07:03 -04:00
] ,
"properties" : {
"id" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true
} ,
"status" : {
"type" : "integer" ,
2023-12-08 05:06:05 -05:00
"format" : "int64" ,
"enum" : [
0 ,
1 ,
2 ,
3 ,
4
]
2023-10-19 05:07:03 -04:00
} ,
"userId" : {
"type" : "string" ,
"nullable" : true
} ,
"appId" : {
"type" : "string"
} ,
"input" : {
"type" : "string"
} ,
"identifier" : {
"type" : "string" ,
"nullable" : true
2023-10-20 07:33:05 -04:00
} ,
"numberOfImages" : {
"type" : "integer" ,
"format" : "int64"
2023-10-20 07:54:36 -04:00
} ,
"completionExpectedAt" : {
"type" : "integer" ,
2023-10-22 07:11:40 -04:00
"format" : "int64" ,
"nullable" : true
2023-10-19 05:07:03 -04:00
}
}
} ,
2023-05-24 10:34:27 -04:00
"UnifiedSearchProvider" : {
"type" : "object" ,
"required" : [
"id" ,
2023-11-06 09:32:52 -05:00
"appId" ,
2023-05-24 10:34:27 -04:00
"name" ,
2023-11-06 09:32:52 -05:00
"icon" ,
"order" ,
2025-07-17 12:03:09 -04:00
"isExternalProvider" ,
2023-11-06 09:32:52 -05:00
"triggers" ,
2023-11-13 10:31:15 -05:00
"filters" ,
"inAppSearch"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
2023-11-06 09:32:52 -05:00
"appId" : {
"type" : "string"
} ,
2023-05-24 10:34:27 -04:00
"name" : {
"type" : "string"
} ,
2023-11-06 09:32:52 -05:00
"icon" : {
"type" : "string"
} ,
2023-05-24 10:34:27 -04:00
"order" : {
"type" : "integer" ,
"format" : "int64"
2023-11-06 09:32:52 -05:00
} ,
2025-07-17 12:03:09 -04:00
"isExternalProvider" : {
"type" : "boolean"
} ,
2023-11-06 09:32:52 -05:00
"triggers" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"filters" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
2023-11-13 10:31:15 -05:00
} ,
"inAppSearch" : {
"type" : "boolean"
2023-05-24 10:34:27 -04:00
}
}
} ,
"UnifiedSearchResult" : {
"type" : "object" ,
"required" : [
"name" ,
"isPaginated" ,
"entries" ,
"cursor"
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"isPaginated" : {
"type" : "boolean"
} ,
"entries" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/UnifiedSearchResultEntry"
}
} ,
"cursor" : {
"nullable" : true ,
"oneOf" : [
{
"type" : "integer" ,
"format" : "int64"
} ,
{
"type" : "string"
}
]
}
}
} ,
"UnifiedSearchResultEntry" : {
"type" : "object" ,
"required" : [
"thumbnailUrl" ,
"title" ,
"subline" ,
"resourceUrl" ,
"icon" ,
"rounded" ,
"attributes"
] ,
"properties" : {
"thumbnailUrl" : {
"type" : "string"
} ,
"title" : {
"type" : "string"
} ,
"subline" : {
"type" : "string"
} ,
"resourceUrl" : {
"type" : "string"
} ,
"icon" : {
"type" : "string"
} ,
"rounded" : {
"type" : "boolean"
} ,
"attributes" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
}
}
}
} ,
"paths" : {
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/getapppassword" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "app_password-get-app-password" ,
"summary" : "Create app password" ,
2024-04-15 03:10:59 -04:00
"description" : "This endpoint requires password confirmation" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"app_password"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
2025-06-01 07:39:11 -04:00
{
2025-06-09 11:39:23 -04:00
"name" : "user-agent" ,
2025-06-01 07:39:11 -04:00
"in" : "header" ,
"schema" : {
"type" : "string"
}
} ,
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "App password returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"apppassword"
] ,
"properties" : {
"apppassword" : {
"type" : "string"
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Creating app password is not allowed" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-04-08 14:09:24 -04:00
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
2024-04-08 14:09:24 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2024-01-10 06:35:44 -05:00
}
2023-05-24 10:34:27 -04:00
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/apppassword" : {
"delete" : {
"operationId" : "app_password-delete-app-password" ,
"summary" : "Delete app password" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"app_password"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "App password deleted successfully" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Deleting app password is not allowed" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-04-08 14:09:24 -04:00
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
2024-04-08 14:09:24 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2024-01-10 06:35:44 -05:00
}
2023-05-24 10:34:27 -04:00
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/apppassword/rotate" : {
"post" : {
"operationId" : "app_password-rotate-app-password" ,
"summary" : "Rotate app password" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"app_password"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "App password returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"apppassword"
] ,
"properties" : {
"apppassword" : {
"type" : "string"
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Rotating app password is not allowed" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-04-08 14:09:24 -04:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-04-08 14:09:24 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/apppassword/confirm" : {
"put" : {
"operationId" : "app_password-confirm-user-password" ,
"summary" : "Confirm the user password" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"app_password"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"password"
] ,
"properties" : {
"password" : {
"type" : "string" ,
"description" : "The password of the user"
}
}
}
2023-05-24 10:34:27 -04:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Password confirmation succeeded" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"lastLogin"
] ,
"properties" : {
"lastLogin" : {
"type" : "integer" ,
"format" : "int64"
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Password confirmation failed" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
2026-01-09 12:06:06 -05:00
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
}
}
}
} ,
"/ocs/v2.php/core/getapppassword-onetime" : {
"get" : {
"operationId" : "app_password-get-app-password-with-one-time-password" ,
"summary" : "Get app password with one-time password" ,
"description" : "This endpoint requires password confirmation" ,
"tags" : [
"app_password"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "user-agent" ,
"in" : "header" ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "App password returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"apppassword"
] ,
"properties" : {
"apppassword" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"403" : {
"description" : "Creating app password is not allowed" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
2024-01-10 06:35:44 -05:00
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
2024-01-21 14:29:54 -05:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/autocomplete/get" : {
"get" : {
"operationId" : "auto_complete-get" ,
"summary" : "Autocomplete a query" ,
2024-01-21 14:29:54 -05:00
"tags" : [
2024-01-10 06:35:44 -05:00
"auto_complete"
2024-01-21 14:29:54 -05:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-08-19 05:08:28 -04:00
"parameters" : [
{
"name" : "search" ,
"in" : "query" ,
"description" : "Text to search for" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "itemType" ,
"in" : "query" ,
"description" : "Type of the items to search for" ,
"schema" : {
"type" : "string" ,
"nullable" : true
}
} ,
{
"name" : "itemId" ,
"in" : "query" ,
"description" : "ID of the items to search for" ,
"schema" : {
"type" : "string" ,
"nullable" : true
}
} ,
{
"name" : "sorter" ,
"in" : "query" ,
"description" : "can be piped, top prio first, e.g.: \"commenters|share-recipients\"" ,
"schema" : {
"type" : "string" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "shareTypes[]" ,
"in" : "query" ,
"description" : "Types of shares to search for" ,
"schema" : {
"type" : "array" ,
"default" : [ ] ,
"items" : {
"type" : "integer" ,
"format" : "int64"
2024-01-10 06:35:44 -05:00
}
}
2024-08-19 05:08:28 -04:00
} ,
{
"name" : "limit" ,
"in" : "query" ,
"description" : "Maximum number of results to return" ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 10
}
} ,
2024-01-10 06:35:44 -05:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
2024-01-21 14:29:54 -05:00
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Autocomplete results returned" ,
2024-01-21 14:29:54 -05:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"ocs"
2024-01-21 14:29:54 -05:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/AutocompleteResult"
}
}
}
2024-01-21 14:29:54 -05:00
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-01-21 14:29:54 -05:00
}
2023-05-24 10:34:27 -04:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/collaboration/resources/collections/{collectionId}" : {
"get" : {
"operationId" : "collaboration_resources-list-collection" ,
"summary" : "Get a collection" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "collectionId" ,
"in" : "path" ,
"description" : "ID of the collection" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "integer" ,
"format" : "int64"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"$ref" : "#/components/schemas/Collection"
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
"404" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2024-01-10 06:35:44 -05:00
} ,
"post" : {
"operationId" : "collaboration_resources-add-resource" ,
"summary" : "Add a resource to a collection" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"resourceType" ,
"resourceId"
] ,
"properties" : {
"resourceType" : {
"type" : "string" ,
"description" : "Name of the resource"
} ,
"resourceId" : {
"type" : "string" ,
"description" : "ID of the resource"
}
}
}
2023-05-24 10:34:27 -04:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "collectionId" ,
"in" : "path" ,
"description" : "ID of the collection" ,
"required" : true ,
2023-05-24 10:34:27 -04:00
"schema" : {
"type" : "integer" ,
2024-01-10 06:35:44 -05:00
"format" : "int64"
2023-05-24 10:34:27 -04:00
}
2023-08-11 08:32:42 -04:00
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
2023-08-11 08:32:42 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-08-11 08:32:42 -04:00
}
2023-05-24 10:34:27 -04:00
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"$ref" : "#/components/schemas/Collection"
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Collection not found or resource inaccessible" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
2023-08-11 08:32:42 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-08-11 08:32:42 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2024-01-10 06:35:44 -05:00
} ,
"delete" : {
"operationId" : "collaboration_resources-remove-resource" ,
"summary" : "Remove a resource from a collection" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "collectionId" ,
"in" : "path" ,
"description" : "ID of the collection" ,
"required" : true ,
2023-05-24 10:34:27 -04:00
"schema" : {
"type" : "integer" ,
2024-01-10 06:35:44 -05:00
"format" : "int64"
2023-05-24 10:34:27 -04:00
}
2023-08-11 08:32:42 -04:00
} ,
2024-08-19 05:08:28 -04:00
{
"name" : "resourceType" ,
"in" : "query" ,
"description" : "Name of the resource" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "resourceId" ,
"in" : "query" ,
"description" : "ID of the resource" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2023-08-11 08:32:42 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
2023-08-11 08:32:42 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-08-11 08:32:42 -04:00
}
2023-05-24 10:34:27 -04:00
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"$ref" : "#/components/schemas/Collection"
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Collection or resource not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
2023-08-11 08:32:42 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-08-11 08:32:42 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2024-01-10 06:35:44 -05:00
} ,
"put" : {
"operationId" : "collaboration_resources-rename-collection" ,
"summary" : "Rename a collection" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"collectionName"
] ,
"properties" : {
"collectionName" : {
"type" : "string" ,
"description" : "New name"
}
}
}
2023-05-24 10:34:27 -04:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "collectionId" ,
"in" : "path" ,
"description" : "ID of the collection" ,
"required" : true ,
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
2023-05-24 10:34:27 -04:00
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"ocs"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"$ref" : "#/components/schemas/Collection"
}
}
}
}
}
}
}
} ,
2023-05-24 10:34:27 -04:00
"404" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/collaboration/resources/collections/search/{filter}" : {
"get" : {
"operationId" : "collaboration_resources-search-collections" ,
"summary" : "Search for collections" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "filter" ,
"in" : "path" ,
"description" : "Filter collections" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "string"
}
2023-09-19 18:49:19 -04:00
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
2023-09-19 18:49:19 -04:00
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collections returned" ,
2023-09-19 18:49:19 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"ocs"
2023-09-19 18:49:19 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/Collection"
2023-09-19 18:49:19 -04:00
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Collection not found" ,
2023-09-19 18:49:19 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"ocs"
2023-09-19 18:49:19 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
2023-09-19 18:49:19 -04:00
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-09-19 18:49:19 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/collaboration/resources/{resourceType}/{resourceId}" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "collaboration_resources-get-collections-by-resource" ,
"summary" : "Get collections by resource" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "resourceType" ,
"in" : "path" ,
"description" : "Type of the resource" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "resourceId" ,
"in" : "path" ,
"description" : "ID of the resource" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collections returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/Collection"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
} ,
"404" : {
"description" : "Resource not accessible" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/collaboration/resources/{baseResourceType}/{baseResourceId}" : {
"post" : {
"operationId" : "collaboration_resources-create-collection-on-resource" ,
"summary" : "Create a collection for a resource" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"collaboration_resources"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"name"
] ,
"properties" : {
"name" : {
"type" : "string" ,
"description" : "Name of the collection"
}
}
}
2024-01-10 06:35:44 -05:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "baseResourceType" ,
"in" : "path" ,
"description" : "Type of the base resource" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "baseResourceId" ,
"in" : "path" ,
"description" : "ID of the base resource" ,
"required" : true ,
"schema" : {
"type" : "string"
2023-05-24 10:34:27 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Collection returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2025-08-26 04:21:10 -04:00
"data" : {
"$ref" : "#/components/schemas/Collection"
}
}
}
}
}
}
}
} ,
"400" : {
"description" : "Creating collection is not possible" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
} ,
2025-08-26 04:21:10 -04:00
"404" : {
"description" : "Resource inaccessible" ,
2024-01-10 06:35:44 -05:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
} ,
2025-08-26 04:21:10 -04:00
"500" : {
"description" : "" ,
2024-01-10 06:35:44 -05:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
} ,
2025-08-26 04:21:10 -04:00
"401" : {
"description" : "Current user is not logged in" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2023-03-15 12:29:32 -04:00
"data" : { }
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/hovercard/v1/{userId}" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "hover_card-get-user" ,
"summary" : "Get the account details for a hovercard" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"hover_card"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "userId" ,
"in" : "path" ,
"description" : "ID of the user" ,
"required" : true ,
2023-05-24 10:34:27 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-05-24 10:34:27 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Account details returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"userId" ,
"displayName" ,
"actions"
] ,
"properties" : {
"userId" : {
"type" : "string"
} ,
"displayName" : {
"type" : "string"
} ,
"actions" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/ContactsAction"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Account not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2023-03-15 12:29:32 -04:00
"data" : { }
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/navigation/apps" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "navigation-get-apps-navigation" ,
"summary" : "Get the apps navigation" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"navigation"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-08-19 05:08:28 -04:00
{
"name" : "absolute" ,
"in" : "query" ,
"description" : "Rewrite URLs to absolute ones" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-08-19 05:08:28 -04:00
}
} ,
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
2023-05-24 10:34:27 -04:00
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Apps navigation returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "array" ,
"items" : {
2024-01-10 06:35:44 -05:00
"$ref" : "#/components/schemas/NavigationEntry"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
} ,
"304" : {
2024-04-08 14:09:24 -04:00
"description" : "No apps navigation changed"
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/core/navigation/settings" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "navigation-get-settings-navigation" ,
"summary" : "Get the settings navigation" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"navigation"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-08-19 05:08:28 -04:00
{
"name" : "absolute" ,
"in" : "query" ,
"description" : "Rewrite URLs to absolute ones" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-08-19 05:08:28 -04:00
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Apps navigation returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/NavigationEntry"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"304" : {
2024-04-08 14:09:24 -04:00
"description" : "No apps navigation changed"
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2024-01-10 06:35:44 -05:00
}
} ,
"/ocs/v2.php/cloud/capabilities" : {
"get" : {
"operationId" : "ocs-get-capabilities" ,
"summary" : "Get the capabilities" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"ocs"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
2024-01-10 06:35:44 -05:00
{ } ,
2023-05-24 10:34:27 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Capabilities returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"version" ,
"capabilities"
] ,
"properties" : {
"version" : {
"type" : "object" ,
"required" : [
"major" ,
"minor" ,
"micro" ,
"string" ,
"edition" ,
"extendedSupport"
] ,
"properties" : {
"major" : {
"type" : "integer" ,
"format" : "int64"
} ,
"minor" : {
"type" : "integer" ,
"format" : "int64"
} ,
"micro" : {
"type" : "integer" ,
"format" : "int64"
} ,
"string" : {
"type" : "string"
} ,
"edition" : {
"type" : "string"
} ,
"extendedSupport" : {
"type" : "boolean"
}
}
} ,
"capabilities" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "object"
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/profile/{targetUserId}" : {
"put" : {
"operationId" : "profile_api-set-visibility" ,
"summary" : "Update the visibility of a parameter" ,
2024-04-15 03:10:59 -04:00
"description" : "This endpoint requires password confirmation" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"profile_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"paramId" ,
"visibility"
] ,
"properties" : {
"paramId" : {
"type" : "string" ,
"description" : "ID of the parameter"
} ,
"visibility" : {
"type" : "string" ,
"description" : "New visibility"
}
}
}
2024-01-10 06:35:44 -05:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "targetUserId" ,
"in" : "path" ,
"description" : "ID of the user" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Visibility updated successfully" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : { }
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"400" : {
"description" : "Updating visibility is not possible" ,
"content" : {
2024-04-08 14:09:24 -04:00
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
2024-04-08 14:09:24 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2024-01-10 06:35:44 -05:00
}
}
}
} ,
2023-05-24 10:34:27 -04:00
"403" : {
2024-01-10 06:35:44 -05:00
"description" : "Not allowed to edit other users visibility" ,
"content" : {
2024-04-08 14:09:24 -04:00
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : {
2024-04-08 14:09:24 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2024-01-10 06:35:44 -05:00
}
}
}
} ,
"404" : {
"description" : "Account not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
2024-04-08 14:09:24 -04:00
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
2024-04-08 14:09:24 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2025-04-23 04:16:06 -04:00
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2025-04-23 04:16:06 -04:00
}
}
} ,
"get" : {
"operationId" : "profile_api-get-profile-fields" ,
"summary" : "Get profile fields for another user" ,
"tags" : [
"profile_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "targetUserId" ,
"in" : "path" ,
"description" : "ID of the user" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Profile data returned successfully" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"$ref" : "#/components/schemas/ProfileData"
}
}
}
}
}
}
}
} ,
"400" : {
"description" : "Profile is disabled" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"nullable" : true
}
}
}
}
}
}
}
} ,
"404" : {
"description" : "Account not found or disabled" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"nullable" : true
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/references/extract" : {
2023-05-24 10:34:27 -04:00
"post" : {
2024-01-10 06:35:44 -05:00
"operationId" : "reference_api-extract" ,
"summary" : "Extract references from a text" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"reference_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"text"
] ,
"properties" : {
"text" : {
"type" : "string" ,
"description" : "Text to extract from"
} ,
"resolve" : {
"type" : "boolean" ,
"default" : false ,
"description" : "Resolve the references"
} ,
"limit" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 1 ,
"description" : "Maximum amount of references to extract"
}
}
}
2024-01-10 06:35:44 -05:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "References returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"references"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"references" : {
"type" : "object" ,
"additionalProperties" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/Reference"
}
]
2024-01-10 06:35:44 -05:00
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-07-08 05:29:26 -04:00
"/ocs/v2.php/references/extractPublic" : {
"post" : {
"operationId" : "reference_api-extract-public" ,
"summary" : "Extract references from a text" ,
"tags" : [
"reference_api"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"text" ,
"sharingToken"
] ,
"properties" : {
"text" : {
"type" : "string" ,
"description" : "Text to extract from"
} ,
"sharingToken" : {
"type" : "string" ,
"description" : "Token of the public share"
} ,
"resolve" : {
"type" : "boolean" ,
"default" : false ,
"description" : "Resolve the references"
} ,
"limit" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 1 ,
"description" : "Maximum amount of references to extract, limited to 15"
}
}
}
}
}
} ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "References returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"references"
] ,
"properties" : {
"references" : {
"type" : "object" ,
"additionalProperties" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/Reference"
}
]
2024-07-08 05:29:26 -04:00
}
}
}
}
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/references/resolve" : {
"get" : {
"operationId" : "reference_api-resolve-one" ,
"summary" : "Resolve a reference" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"reference_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-08-19 05:08:28 -04:00
{
"name" : "reference" ,
"in" : "query" ,
"description" : "Reference to resolve" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Reference returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"references"
] ,
"properties" : {
"references" : {
"type" : "object" ,
"additionalProperties" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/Reference"
}
]
2024-01-10 06:35:44 -05:00
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2024-01-10 06:35:44 -05:00
} ,
"post" : {
"operationId" : "reference_api-resolve" ,
"summary" : "Resolve multiple references" ,
2024-02-20 03:32:33 -05:00
"tags" : [
2024-01-10 06:35:44 -05:00
"reference_api"
2024-02-20 03:32:33 -05:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"references"
] ,
"properties" : {
"references" : {
"type" : "array" ,
"description" : "References to resolve" ,
"items" : {
"type" : "string"
}
} ,
"limit" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 1 ,
"description" : "Maximum amount of references to resolve"
}
}
2024-01-10 06:35:44 -05:00
}
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2024-02-20 03:32:33 -05:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
2024-07-08 05:29:26 -04:00
"responses" : {
"200" : {
"description" : "References returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"references"
] ,
"properties" : {
"references" : {
"type" : "object" ,
"additionalProperties" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/Reference"
}
]
2024-07-08 05:29:26 -04:00
}
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-07-08 05:29:26 -04:00
}
}
}
} ,
"/ocs/v2.php/references/resolvePublic" : {
"get" : {
"operationId" : "reference_api-resolve-one-public" ,
"summary" : "Resolve from a public page" ,
"tags" : [
"reference_api"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
2024-08-19 05:08:28 -04:00
{
"name" : "reference" ,
"in" : "query" ,
"description" : "Reference to resolve" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "sharingToken" ,
"in" : "query" ,
"description" : "Token of the public share" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2024-07-08 05:29:26 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Reference returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"references"
] ,
"properties" : {
"references" : {
"type" : "object" ,
"additionalProperties" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/Reference"
}
]
2024-07-08 05:29:26 -04:00
}
}
}
}
}
}
}
}
}
}
}
}
} ,
"post" : {
"operationId" : "reference_api-resolve-public" ,
"summary" : "Resolve multiple references from a public page" ,
"tags" : [
"reference_api"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"references" ,
"sharingToken"
] ,
"properties" : {
"references" : {
"type" : "array" ,
"description" : "References to resolve" ,
"items" : {
"type" : "string"
}
} ,
"sharingToken" : {
"type" : "string" ,
"description" : "Token of the public share"
} ,
"limit" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 1 ,
"description" : "Maximum amount of references to resolve, limited to 15"
}
}
}
}
}
} ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
2024-02-20 03:32:33 -05:00
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "References returned" ,
2024-02-20 03:32:33 -05:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"references"
2024-02-20 03:32:33 -05:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"references" : {
"type" : "object" ,
"additionalProperties" : {
2025-07-25 21:26:52 -04:00
"nullable" : true ,
"allOf" : [
{
"$ref" : "#/components/schemas/Reference"
}
]
2024-01-10 06:35:44 -05:00
}
2024-02-20 03:32:33 -05:00
}
}
}
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
}
}
}
} ,
"/ocs/v2.php/references/providers" : {
"get" : {
"operationId" : "reference_api-get-providers-info" ,
"summary" : "Get the providers" ,
"tags" : [
"reference_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
2024-02-20 03:32:33 -05:00
} ,
2024-01-10 06:35:44 -05:00
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Providers returned" ,
2024-02-20 03:32:33 -05:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/ReferenceProvider"
}
}
2024-02-20 03:32:33 -05:00
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-02-20 03:32:33 -05:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/references/provider/{providerId}" : {
"put" : {
"operationId" : "reference_api-touch-provider" ,
"summary" : "Touch a provider" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"reference_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : false ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"properties" : {
"timestamp" : {
"type" : "integer" ,
"format" : "int64" ,
"nullable" : true ,
2025-06-01 07:39:11 -04:00
"default" : null ,
2024-07-02 03:08:04 -04:00
"description" : "Timestamp of the last usage"
}
}
}
2024-01-10 06:35:44 -05:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "providerId" ,
2023-05-24 10:34:27 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "ID of the provider" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Provider touched" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"success"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"success" : {
"type" : "boolean"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-05-02 05:46:49 -04:00
"/ocs/v2.php/taskprocessing/tasktypes" : {
"get" : {
"operationId" : "task_processing_api-task-types" ,
2024-05-16 06:43:09 -04:00
"summary" : "Returns all available TaskProcessing task types" ,
2024-05-02 05:46:49 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Task types returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"types"
] ,
"properties" : {
"types" : {
"type" : "object" ,
"additionalProperties" : {
"$ref" : "#/components/schemas/TaskProcessingTaskType"
}
}
}
}
}
}
}
}
}
}
2025-08-28 03:26:05 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-05-02 05:46:49 -04:00
}
}
}
} ,
"/ocs/v2.php/taskprocessing/schedule" : {
"post" : {
"operationId" : "task_processing_api-schedule" ,
2024-05-16 06:43:09 -04:00
"summary" : "Schedules a task" ,
2024-05-02 05:46:49 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"input" ,
"type" ,
"appId"
] ,
"properties" : {
"input" : {
"type" : "object" ,
"description" : "Task's input parameters" ,
"additionalProperties" : {
"type" : "object"
}
} ,
"type" : {
"type" : "string" ,
"description" : "Type of the task"
} ,
"appId" : {
"type" : "string" ,
"description" : "ID of the app that will execute the task"
} ,
"customId" : {
"type" : "string" ,
"default" : "" ,
"description" : "An arbitrary identifier for the task"
2024-07-17 06:35:13 -04:00
} ,
"webhookUri" : {
"type" : "string" ,
"nullable" : true ,
2025-06-01 07:39:11 -04:00
"default" : null ,
2024-07-17 06:35:13 -04:00
"description" : "URI to be requested when the task finishes"
} ,
"webhookMethod" : {
"type" : "string" ,
"nullable" : true ,
2025-06-01 07:39:11 -04:00
"default" : null ,
2024-07-17 06:35:13 -04:00
"description" : "Method used for the webhook request (HTTP:GET, HTTP:POST, HTTP:PUT, HTTP:DELETE or AppAPI:APP_ID:GET, AppAPI:APP_ID:POST...)"
2025-11-26 09:48:30 -05:00
} ,
"includeWatermark" : {
"type" : "boolean" ,
"default" : true ,
"description" : "Whether to include a watermark in the output file or not"
2024-07-02 03:08:04 -04:00
}
}
}
2024-05-02 05:46:49 -04:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2024-05-02 05:46:49 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Task scheduled successfully" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TaskProcessingTask"
}
}
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"400" : {
"description" : "Scheduling task is not possible" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"412" : {
"description" : "Scheduling task is not possible" ,
"content" : {
"application/json" : {
2024-05-06 05:24:35 -04:00
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"401" : {
"description" : "Cannot schedule task because it references files in its input that the user doesn't have access to" ,
"content" : {
"application/json" : {
2024-05-02 05:46:49 -04:00
"schema" : {
2025-08-28 03:26:05 -04:00
"anyOf" : [
{
2024-05-02 05:46:49 -04:00
"type" : "object" ,
"required" : [
2025-08-28 03:26:05 -04:00
"ocs"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
2025-08-28 03:26:05 -04:00
"ocs" : {
2024-05-02 05:46:49 -04:00
"type" : "object" ,
"required" : [
2025-08-28 03:26:05 -04:00
"meta" ,
"data"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
2025-08-28 03:26:05 -04:00
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
2024-05-02 05:46:49 -04:00
}
}
}
}
2025-08-28 03:26:05 -04:00
} ,
{
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
2024-05-02 05:46:49 -04:00
}
2025-08-28 03:26:05 -04:00
]
2024-05-02 05:46:49 -04:00
}
}
}
}
}
}
} ,
"/ocs/v2.php/taskprocessing/task/{id}" : {
"get" : {
"operationId" : "task_processing_api-get-task" ,
2024-05-16 06:43:09 -04:00
"summary" : "Gets a task including status and result" ,
"description" : "Tasks are removed 1 week after receiving their last update" ,
2024-05-02 05:46:49 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "id" ,
"in" : "path" ,
"description" : "The id of the task" ,
"required" : true ,
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Task returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TaskProcessingTask"
}
}
}
}
}
}
}
}
}
} ,
"404" : {
"description" : "Task not found" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
2025-08-28 03:26:05 -04:00
}
}
}
}
}
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
2024-05-02 05:46:49 -04:00
}
}
}
}
}
}
}
} ,
"delete" : {
"operationId" : "task_processing_api-delete-task" ,
2024-05-16 06:43:09 -04:00
"summary" : "Deletes a task" ,
2024-05-02 05:46:49 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "id" ,
"in" : "path" ,
"description" : "The id of the task" ,
"required" : true ,
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
2024-05-16 08:56:12 -04:00
"description" : "Task deleted" ,
2024-05-03 04:14:19 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-05-06 10:36:35 -04:00
"nullable" : true
2024-05-03 04:14:19 -04:00
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
2024-05-02 05:46:49 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-05-03 04:14:19 -04:00
"message"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
2024-05-03 04:14:19 -04:00
"message" : {
"type" : "string"
2024-05-02 05:46:49 -04:00
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-05-03 04:14:19 -04:00
}
}
}
} ,
"/ocs/v2.php/taskprocessing/tasks/app/{appId}" : {
"get" : {
"operationId" : "task_processing_api-list-tasks-by-app" ,
2024-05-16 06:43:09 -04:00
"summary" : "Returns tasks for the current user filtered by the appId and optional customId" ,
2024-05-03 04:14:19 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
2024-05-02 05:46:49 -04:00
} ,
2024-05-03 04:14:19 -04:00
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-05-03 04:14:19 -04:00
{
"name" : "appId" ,
"in" : "path" ,
"description" : "ID of the app" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2024-08-19 05:08:28 -04:00
{
"name" : "customId" ,
"in" : "query" ,
"description" : "An arbitrary identifier for the task" ,
"schema" : {
"type" : "string" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
2024-05-03 04:14:19 -04:00
{
"name" : "OCS-APIRequest" ,
2024-05-10 01:08:31 -04:00
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
2024-05-16 08:56:12 -04:00
"description" : "Tasks returned" ,
2024-05-10 01:08:31 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"tasks"
] ,
"properties" : {
"tasks" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/TaskProcessingTask"
}
}
}
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-05-10 01:08:31 -04:00
}
}
}
} ,
"/ocs/v2.php/taskprocessing/tasks" : {
"get" : {
2024-05-16 06:43:09 -04:00
"operationId" : "task_processing_api-list-tasks" ,
"summary" : "Returns tasks for the current user filtered by the optional taskType and optional customId" ,
2024-05-10 01:08:31 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-05-10 01:08:31 -04:00
{
2024-08-19 05:08:28 -04:00
"name" : "taskType" ,
"in" : "query" ,
"description" : "The task type to filter by" ,
2024-05-03 04:14:19 -04:00
"schema" : {
2024-08-19 05:08:28 -04:00
"type" : "string" ,
"nullable" : true
}
} ,
{
"name" : "customId" ,
"in" : "query" ,
"description" : "An arbitrary identifier for the task" ,
"schema" : {
"type" : "string" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
2024-05-03 04:14:19 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-05-16 08:56:12 -04:00
"description" : "Tasks returned" ,
2024-05-02 05:46:49 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-05-03 04:14:19 -04:00
"tasks"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
2024-05-03 04:14:19 -04:00
"tasks" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/TaskProcessingTask"
}
2024-05-02 05:46:49 -04:00
}
}
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-05-02 05:46:49 -04:00
}
}
}
} ,
2024-05-03 04:14:19 -04:00
"/ocs/v2.php/taskprocessing/tasks/{taskId}/file/{fileId}" : {
2024-05-02 05:46:49 -04:00
"get" : {
2024-05-03 04:14:19 -04:00
"operationId" : "task_processing_api-get-file-contents" ,
2024-05-16 06:43:09 -04:00
"summary" : "Returns the contents of a file referenced in a task" ,
2024-05-02 05:46:49 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-05-03 04:14:19 -04:00
"name" : "taskId" ,
"in" : "path" ,
"description" : "The id of the task" ,
"required" : true ,
2024-05-02 05:46:49 -04:00
"schema" : {
2024-05-03 04:14:19 -04:00
"type" : "integer" ,
"format" : "int64"
2024-05-02 05:46:49 -04:00
}
} ,
{
2024-05-03 04:14:19 -04:00
"name" : "fileId" ,
2024-05-02 05:46:49 -04:00
"in" : "path" ,
2024-05-03 04:14:19 -04:00
"description" : "The file id of the file to retrieve" ,
2024-05-02 05:46:49 -04:00
"required" : true ,
"schema" : {
2024-05-03 04:14:19 -04:00
"type" : "integer" ,
"format" : "int64"
2024-05-02 05:46:49 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
2024-05-03 04:14:19 -04:00
"description" : "File content returned" ,
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
}
}
}
} ,
"500" : {
"description" : "" ,
2024-05-02 05:46:49 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-05-03 04:14:19 -04:00
"message"
2024-05-02 05:46:49 -04:00
] ,
"properties" : {
2024-05-03 04:14:19 -04:00
"message" : {
"type" : "string"
2024-05-02 05:46:49 -04:00
}
}
}
}
}
}
}
}
}
} ,
2024-05-03 04:14:19 -04:00
"404" : {
"description" : "Task or file not found" ,
2024-05-02 05:46:49 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
2024-05-07 07:23:53 -04:00
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-05-07 07:23:53 -04:00
}
}
}
} ,
"/ocs/v2.php/taskprocessing/tasks/{taskId}/cancel" : {
"post" : {
"operationId" : "task_processing_api-cancel-task" ,
2024-05-16 06:43:09 -04:00
"summary" : "Cancels a task" ,
2024-05-07 07:23:53 -04:00
"tags" : [
"task_processing_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "taskId" ,
"in" : "path" ,
"description" : "The id of the task" ,
"required" : true ,
"schema" : {
"type" : "integer" ,
"format" : "int64"
2024-05-02 05:46:49 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
2024-05-16 08:56:12 -04:00
"description" : "Task canceled successfully" ,
2024-05-02 05:46:49 -04:00
"content" : {
2024-05-03 04:14:19 -04:00
"application/json" : {
2024-05-02 05:46:49 -04:00
"schema" : {
2024-05-03 04:14:19 -04:00
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TaskProcessingTask"
}
}
}
}
}
}
2024-05-02 05:46:49 -04:00
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"404" : {
2024-05-03 04:14:19 -04:00
"description" : "Task not found" ,
2024-05-02 05:46:49 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-02-26 10:30:16 -05:00
"/ocs/v2.php/teams/{teamId}/resources" : {
"get" : {
"operationId" : "teams_api-resolve-one" ,
"summary" : "Get all resources of a team" ,
"tags" : [
"teams_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "teamId" ,
"in" : "path" ,
"description" : "Unique id of the team" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Resources returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"resources"
] ,
"properties" : {
"resources" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/TeamResource"
}
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-02-26 10:30:16 -05:00
}
}
}
} ,
"/ocs/v2.php/teams/resources/{providerId}/{resourceId}" : {
"get" : {
"operationId" : "teams_api-list-teams" ,
"summary" : "Get all teams of a resource" ,
"tags" : [
"teams_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "providerId" ,
"in" : "path" ,
"description" : "Identifier of the provider (e.g. deck, talk, collectives)" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "resourceId" ,
"in" : "path" ,
"description" : "Unique id of the resource to list teams for (e.g. deck board id)" ,
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Teams returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"teams"
] ,
"properties" : {
"teams" : {
"type" : "array" ,
"items" : {
2025-10-13 07:55:05 -04:00
"$ref" : "#/components/schemas/TeamWithResources"
2024-02-26 10:30:16 -05:00
}
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-02-26 10:30:16 -05:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/textprocessing/tasktypes" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "text_processing_api-task-types" ,
"summary" : "This endpoint returns all available LanguageModel task types" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_processing_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
2024-01-10 06:35:44 -05:00
{ } ,
2023-05-24 10:34:27 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task types returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"types"
] ,
"properties" : {
"types" : {
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"id" ,
"name" ,
"description"
] ,
"properties" : {
"id" : {
"type" : "string"
} ,
"name" : {
"type" : "string"
} ,
"description" : {
"type" : "string"
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/textprocessing/schedule" : {
"post" : {
"operationId" : "text_processing_api-schedule" ,
"summary" : "This endpoint allows scheduling a language model task" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_processing_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"input" ,
"type" ,
"appId"
] ,
"properties" : {
"input" : {
"type" : "string" ,
"description" : "Input text"
} ,
"type" : {
"type" : "string" ,
"description" : "Type of the task"
} ,
"appId" : {
"type" : "string" ,
"description" : "ID of the app that will execute the task"
} ,
"identifier" : {
"type" : "string" ,
"default" : "" ,
"description" : "An arbitrary identifier for the task"
}
}
}
2023-05-24 10:34:27 -04:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task scheduled successfully" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TextProcessingTask"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"400" : {
"description" : "Scheduling task is not possible" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
} ,
"412" : {
"description" : "Scheduling task is not possible" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
2025-10-14 02:51:32 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
}
}
}
} ,
"/ocs/v2.php/textprocessing/task/{id}" : {
"get" : {
"operationId" : "text_processing_api-get-task" ,
"summary" : "This endpoint allows checking the status and results of a task. Tasks are removed 1 week after receiving their last update." ,
"tags" : [
"text_processing_api"
] ,
"security" : [
2023-05-24 10:34:27 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "id" ,
2023-05-24 10:34:27 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "The id of the task" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TextProcessingTask"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
"404" : {
2024-01-10 06:35:44 -05:00
"description" : "Task not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-10-14 02:51:32 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"delete" : {
"operationId" : "text_processing_api-delete-task" ,
"summary" : "This endpoint allows to delete a scheduled task for a user" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_processing_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "id" ,
2023-05-24 10:34:27 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "The id of the task" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TextProcessingTask"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
"404" : {
2024-01-10 06:35:44 -05:00
"description" : "Task not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
} ,
2025-08-26 04:21:10 -04:00
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"401" : {
"description" : "Current user is not logged in" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2025-08-26 04:21:10 -04:00
"data" : { }
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
}
} ,
"/ocs/v2.php/textprocessing/tasks/app/{appId}" : {
"get" : {
"operationId" : "text_processing_api-list-tasks-by-app" ,
"summary" : "This endpoint returns a list of tasks of a user that are related with a specific appId and optionally with an identifier" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_processing_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "appId" ,
2023-05-24 10:34:27 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "ID of the app" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-05-24 10:34:27 -04:00
}
} ,
2024-08-19 05:08:28 -04:00
{
"name" : "identifier" ,
"in" : "query" ,
"description" : "An arbitrary identifier for the task" ,
"schema" : {
"type" : "string" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task list returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"tasks"
] ,
"properties" : {
"tasks" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/TextProcessingTask"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
}
}
}
} ,
"/ocs/v2.php/text2image/is_available" : {
"get" : {
"operationId" : "text_to_image_api-is-available" ,
"summary" : "Check whether this feature is available" ,
"tags" : [
"text_to_image_api"
] ,
"security" : [
{
"bearer_auth" : [ ]
2023-05-24 10:34:27 -04:00
} ,
2024-01-10 06:35:44 -05:00
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
"description" : "Required to be true for the API request to pass" ,
"required" : true ,
"schema" : {
"type" : "boolean" ,
"default" : true
}
}
] ,
"responses" : {
"200" : {
"description" : "Returns availability status" ,
"content" : {
"application/json" : {
2023-05-24 10:34:27 -04:00
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"isAvailable"
] ,
"properties" : {
"isAvailable" : {
"type" : "boolean"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-10-15 03:33:35 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/text2image/schedule" : {
"post" : {
"operationId" : "text_to_image_api-schedule" ,
"summary" : "This endpoint allows scheduling a text to image task" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_to_image_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"input" ,
"appId"
] ,
"properties" : {
"input" : {
"type" : "string" ,
"description" : "Input text"
} ,
"appId" : {
"type" : "string" ,
"description" : "ID of the app that will execute the task"
} ,
"identifier" : {
"type" : "string" ,
"default" : "" ,
"description" : "An arbitrary identifier for the task"
} ,
"numberOfImages" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 8 ,
"description" : "The number of images to generate"
}
}
}
2024-01-10 06:35:44 -05:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task scheduled successfully" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TextToImageTask"
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"412" : {
"description" : "Scheduling task is not possible" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-10-15 03:33:35 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/text2image/task/{id}" : {
"get" : {
"operationId" : "text_to_image_api-get-task" ,
"summary" : "This endpoint allows checking the status and results of a task. Tasks are removed 1 week after receiving their last update." ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_to_image_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "id" ,
2023-05-24 10:34:27 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "The id of the task" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "integer" ,
"format" : "int64"
2023-05-24 10:34:27 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"task"
] ,
"properties" : {
"task" : {
"$ref" : "#/components/schemas/TextToImageTask"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
"404" : {
2024-01-10 06:35:44 -05:00
"description" : "Task not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-10-15 03:33:35 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
2024-01-10 06:35:44 -05:00
} ,
"delete" : {
"operationId" : "text_to_image_api-delete-task" ,
"summary" : "This endpoint allows to delete a scheduled task for a user" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_to_image_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "id" ,
"in" : "path" ,
"description" : "The id of the task" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "integer" ,
"format" : "int64"
2023-05-24 10:34:27 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"task"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"task" : {
"$ref" : "#/components/schemas/TextToImageTask"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Task not found" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
}
}
2023-07-31 11:03:06 -04:00
}
2023-05-24 10:34:27 -04:00
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"message"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"message" : {
"type" : "string"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/text2image/task/{id}/image/{index}" : {
"get" : {
"operationId" : "text_to_image_api-get-image" ,
"summary" : "This endpoint allows downloading the resulting image of a task" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_to_image_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "id" ,
"in" : "path" ,
"description" : "The id of the task" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "integer" ,
2024-01-10 06:35:44 -05:00
"format" : "int64"
2023-05-24 10:34:27 -04:00
}
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "index" ,
"in" : "path" ,
"description" : "The index of the image to retrieve" ,
"required" : true ,
2023-05-24 10:34:27 -04:00
"schema" : {
"type" : "integer" ,
2024-01-10 06:35:44 -05:00
"format" : "int64"
2023-05-24 10:34:27 -04:00
}
} ,
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Image returned" ,
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
}
}
}
} ,
"404" : {
"description" : "Task or image not found" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"message"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"message" : {
"type" : "string"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
2025-10-15 03:33:35 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/text2image/tasks/app/{appId}" : {
"get" : {
"operationId" : "text_to_image_api-list-tasks-by-app" ,
"summary" : "This endpoint returns a list of tasks of a user that are related with a specific appId and optionally with an identifier" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"text_to_image_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2023-05-24 10:34:27 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "appId" ,
2023-05-24 10:34:27 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "ID of the app" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2024-08-19 05:08:28 -04:00
{
"name" : "identifier" ,
"in" : "query" ,
"description" : "An arbitrary identifier for the task" ,
"schema" : {
"type" : "string" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Task list returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"tasks"
2023-05-24 10:34:27 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"tasks" : {
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/TextToImageTask"
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"500" : {
"description" : "" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
2024-01-10 06:35:44 -05:00
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/translation/languages" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "translation_api-languages" ,
"summary" : "Get the list of supported languages" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"translation_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
2024-01-10 06:35:44 -05:00
{ } ,
2023-05-24 10:34:27 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Supported languages returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"languages" ,
"languageDetection"
] ,
"properties" : {
"languages" : {
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"from" ,
"fromLabel" ,
"to" ,
"toLabel"
] ,
"properties" : {
"from" : {
"type" : "string"
} ,
"fromLabel" : {
"type" : "string"
} ,
"to" : {
"type" : "string"
} ,
"toLabel" : {
"type" : "string"
}
}
}
} ,
"languageDetection" : {
"type" : "boolean"
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/translation/translate" : {
"post" : {
"operationId" : "translation_api-translate" ,
"summary" : "Translate a text" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"translation_api"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
2024-01-10 06:35:44 -05:00
{ } ,
2023-05-24 10:34:27 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"text" ,
"toLanguage"
] ,
"properties" : {
"text" : {
"type" : "string" ,
"description" : "Text to be translated"
} ,
"fromLanguage" : {
"type" : "string" ,
"nullable" : true ,
"description" : "Language to translate from"
} ,
"toLanguage" : {
"type" : "string" ,
"description" : "Language to translate to"
}
}
}
2023-05-24 10:34:27 -04:00
}
2024-07-02 03:08:04 -04:00
}
} ,
"parameters" : [
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Translated text returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"text" ,
"from"
] ,
"properties" : {
"text" : {
"type" : "string"
} ,
"from" : {
"type" : "string" ,
"nullable" : true
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
"400" : {
2024-01-10 06:35:44 -05:00
"description" : "Language not detected or unable to translate" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
} ,
"from" : {
"type" : "string" ,
"nullable" : true
}
}
}
}
}
}
}
}
}
} ,
"412" : {
"description" : "Translating is not possible" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
} ,
"from" : {
"type" : "string" ,
"nullable" : true
}
}
}
}
}
}
}
}
}
} ,
"500" : {
"description" : "" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
} ,
"from" : {
"type" : "string" ,
"nullable" : true
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/search/providers" : {
2023-05-24 10:34:27 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "unified_search-get-providers" ,
"summary" : "Get the providers for unified search" ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"unified_search"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-08-19 05:08:28 -04:00
{
"name" : "from" ,
"in" : "query" ,
"description" : "the url the user is currently at" ,
"schema" : {
"type" : "string" ,
"default" : ""
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Providers returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "array" ,
"items" : {
"$ref" : "#/components/schemas/UnifiedSearchProvider"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-05-24 10:34:27 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/ocs/v2.php/search/providers/{providerId}/search" : {
"get" : {
"operationId" : "unified_search-search" ,
"summary" : "Launch a search for a specific search provider." ,
"description" : "Additional filters are available for each provider. Send a request to /providers endpoint to list providers with their available filters." ,
2023-05-24 10:34:27 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"unified_search"
2023-05-24 10:34:27 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "providerId" ,
"in" : "path" ,
"description" : "ID of the provider" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
2024-08-19 05:08:28 -04:00
{
"name" : "term" ,
"in" : "query" ,
"description" : "Term to search" ,
"schema" : {
"type" : "string" ,
"default" : ""
}
} ,
{
"name" : "sortOrder" ,
"in" : "query" ,
"description" : "Order of entries" ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "limit" ,
"in" : "query" ,
2025-09-30 09:04:22 -04:00
"description" : "Maximum amount of entries (capped by configurable unified-search.max-results-per-request, default: 25)" ,
2024-08-19 05:08:28 -04:00
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
2025-06-01 07:39:11 -04:00
"nullable" : true ,
"default" : null
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "cursor" ,
"in" : "query" ,
"description" : "Offset for searching" ,
"schema" : {
"nullable" : true ,
2025-06-01 07:39:11 -04:00
"default" : null ,
2024-08-19 05:08:28 -04:00
"oneOf" : [
{
"type" : "integer" ,
"format" : "int64"
} ,
{
"type" : "string"
}
]
}
} ,
{
"name" : "from" ,
"in" : "query" ,
"description" : "The current user URL" ,
"schema" : {
"type" : "string" ,
"default" : ""
}
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "OCS-APIRequest" ,
"in" : "header" ,
2023-09-27 04:22:20 -04:00
"description" : "Required to be true for the API request to pass" ,
2023-05-24 10:34:27 -04:00
"required" : true ,
"schema" : {
2023-09-27 04:22:20 -04:00
"type" : "boolean" ,
"default" : true
2023-05-24 10:34:27 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Search entries returned" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"$ref" : "#/components/schemas/UnifiedSearchResult"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
} ,
"400" : {
2024-01-10 06:35:44 -05:00
"description" : "Searching is not possible" ,
2023-05-24 10:34:27 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-05-24 10:34:27 -04:00
}
}
}
}
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"ocs"
] ,
"properties" : {
"ocs" : {
"type" : "object" ,
"required" : [
"meta" ,
"data"
] ,
"properties" : {
"meta" : {
"$ref" : "#/components/schemas/OCSMeta"
} ,
"data" : { }
}
}
}
}
}
}
2023-07-31 05:58:54 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/avatar/{userId}/{size}/dark" : {
"get" : {
"operationId" : "avatar-get-avatar-dark" ,
"summary" : "Get the dark avatar" ,
2023-07-31 05:58:54 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"avatar"
2023-07-31 05:58:54 -04:00
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2023-07-31 05:58:54 -04:00
{
2024-01-10 06:35:44 -05:00
"name" : "userId" ,
"in" : "path" ,
"description" : "ID of the user" ,
2023-07-31 05:58:54 -04:00
"required" : true ,
"schema" : {
"type" : "string"
}
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "size" ,
"in" : "path" ,
"description" : "Size of the avatar" ,
2023-07-31 05:58:54 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "integer" ,
2024-08-14 03:29:30 -04:00
"format" : "int64" ,
"enum" : [
64 ,
512
]
2024-01-10 06:35:44 -05:00
}
2024-08-19 05:08:28 -04:00
} ,
{
"name" : "guestFallback" ,
"in" : "query" ,
"description" : "Fallback to guest avatar if not found" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-08-19 05:08:28 -04:00
}
2024-01-10 06:35:44 -05:00
}
] ,
"responses" : {
"200" : {
"description" : "Avatar returned" ,
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
}
}
2023-07-31 05:58:54 -04:00
}
} ,
2024-06-07 06:09:36 -04:00
"201" : {
"description" : "Avatar returned" ,
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Avatar not found" ,
"content" : {
"application/json" : {
"schema" : { }
}
2023-07-31 05:58:54 -04:00
}
2024-06-07 06:09:36 -04:00
} ,
"500" : {
"description" : ""
2024-01-10 06:35:44 -05:00
}
}
}
} ,
"/index.php/avatar/{userId}/{size}" : {
"get" : {
"operationId" : "avatar-get-avatar" ,
"summary" : "Get the avatar" ,
"tags" : [
"avatar"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
2023-07-31 05:58:54 -04:00
} ,
{
2024-01-10 06:35:44 -05:00
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "userId" ,
"in" : "path" ,
"description" : "ID of the user" ,
"required" : true ,
2023-07-31 05:58:54 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-07-31 05:58:54 -04:00
}
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "size" ,
"in" : "path" ,
"description" : "Size of the avatar" ,
2023-07-31 05:58:54 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "integer" ,
2024-08-14 03:29:30 -04:00
"format" : "int64" ,
"enum" : [
64 ,
512
]
2023-07-31 05:58:54 -04:00
}
2024-08-19 05:08:28 -04:00
} ,
{
"name" : "guestFallback" ,
"in" : "query" ,
"description" : "Fallback to guest avatar if not found" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-08-19 05:08:28 -04:00
}
2023-07-31 05:58:54 -04:00
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Avatar returned" ,
"headers" : {
"X-NC-IsCustomAvatar" : {
2023-07-31 05:58:54 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "integer" ,
"format" : "int64"
}
}
} ,
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
2023-07-31 05:58:54 -04:00
}
}
}
2023-11-06 08:52:59 -05:00
} ,
2024-06-07 06:09:36 -04:00
"201" : {
"description" : "Avatar returned" ,
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Avatar not found" ,
2023-11-06 08:52:59 -05:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
2023-11-06 08:52:59 -05:00
}
}
2024-06-07 06:09:36 -04:00
} ,
"500" : {
"description" : ""
2024-01-10 06:35:44 -05:00
}
}
}
} ,
2024-07-25 11:52:47 -04:00
"/index.php/csrftoken" : {
"get" : {
"operationId" : "csrf_token-index" ,
"summary" : "Returns a new CSRF token." ,
"tags" : [
"csrf_token"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"responses" : {
"200" : {
"description" : "CSRF token returned" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"token"
] ,
"properties" : {
"token" : {
"type" : "string"
}
}
}
}
}
} ,
"403" : {
"description" : "Strict cookie check failed" ,
"content" : {
"application/json" : {
"schema" : { }
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/login/v2/poll" : {
"post" : {
"operationId" : "client_flow_login_v2-poll" ,
"summary" : "Poll the login flow credentials" ,
"tags" : [
"client_flow_login_v2"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
2023-07-31 05:58:54 -04:00
} ,
2024-01-10 06:35:44 -05:00
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"token"
] ,
"properties" : {
"token" : {
"type" : "string" ,
"description" : "Token of the flow"
}
}
}
2024-01-10 06:35:44 -05:00
}
}
2024-07-02 03:08:04 -04:00
} ,
2024-01-10 06:35:44 -05:00
"responses" : {
"200" : {
"description" : "Login flow credentials returned" ,
2023-07-31 05:58:54 -04:00
"content" : {
"application/json" : {
"schema" : {
2024-01-10 06:35:44 -05:00
"$ref" : "#/components/schemas/LoginFlowV2Credentials"
2023-07-31 05:58:54 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Login flow not found or completed" ,
"content" : {
"application/json" : {
"schema" : { }
}
}
}
}
}
} ,
"/index.php/login/v2" : {
"post" : {
"operationId" : "client_flow_login_v2-init" ,
"summary" : "Init a login flow" ,
"tags" : [
"client_flow_login_v2"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2025-06-01 07:39:11 -04:00
"parameters" : [
{
2025-06-09 11:39:23 -04:00
"name" : "user-agent" ,
2025-06-01 07:39:11 -04:00
"in" : "header" ,
"schema" : {
"type" : "string"
}
}
] ,
2024-01-10 06:35:44 -05:00
"responses" : {
"200" : {
"description" : "Login flow init returned" ,
2023-07-31 05:58:54 -04:00
"content" : {
"application/json" : {
"schema" : {
2024-01-10 06:35:44 -05:00
"$ref" : "#/components/schemas/LoginFlowV2"
2023-07-31 05:58:54 -04:00
}
}
}
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/avatar/guest/{guestName}/{size}" : {
2023-07-31 05:58:54 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "guest_avatar-get-avatar" ,
"summary" : "Returns a guest avatar image response" ,
2023-07-31 05:58:54 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"guest_avatar"
2023-07-31 05:58:54 -04:00
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"parameters" : [
2024-01-10 06:35:44 -05:00
{
"name" : "guestName" ,
2023-07-31 05:58:54 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "The guest name, e.g. \"Albert\"" ,
2023-07-31 05:58:54 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-07-31 05:58:54 -04:00
}
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "size" ,
"in" : "path" ,
"description" : "The desired avatar size, e.g. 64 for 64x64px" ,
2023-07-31 05:58:54 -04:00
"required" : true ,
"schema" : {
2024-08-14 03:29:30 -04:00
"type" : "integer" ,
"format" : "int64" ,
"enum" : [
64 ,
512
]
2023-07-31 05:58:54 -04:00
}
2024-08-19 05:08:28 -04:00
} ,
{
"name" : "darkTheme" ,
"in" : "query" ,
"description" : "Return dark avatar" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
2024-08-19 05:08:28 -04:00
"nullable" : true ,
2025-09-01 10:03:07 -04:00
"default" : false
2024-08-19 05:08:28 -04:00
}
2023-07-31 05:58:54 -04:00
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Custom avatar returned" ,
2024-06-07 06:09:36 -04:00
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
2023-07-31 05:58:54 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"*/*" : {
2023-07-31 05:58:54 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string" ,
"format" : "binary"
2023-07-31 05:58:54 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"201" : {
"description" : "Avatar returned" ,
2024-06-07 06:09:36 -04:00
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
2023-07-31 05:58:54 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"*/*" : {
2023-07-31 05:58:54 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string" ,
"format" : "binary"
2023-08-11 05:37:56 -04:00
}
}
}
} ,
"500" : {
2024-01-10 06:35:44 -05:00
"description" : ""
2023-08-11 05:37:56 -04:00
}
}
2024-01-10 06:35:44 -05:00
}
} ,
"/index.php/avatar/guest/{guestName}/{size}/dark" : {
"get" : {
"operationId" : "guest_avatar-get-avatar-dark" ,
"summary" : "Returns a dark guest avatar image response" ,
2023-08-11 05:37:56 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"guest_avatar"
2023-08-11 05:37:56 -04:00
] ,
"security" : [
2024-01-10 06:35:44 -05:00
{ } ,
2023-08-11 05:37:56 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "guestName" ,
2023-08-11 05:37:56 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "The guest name, e.g. \"Albert\"" ,
2023-08-11 05:37:56 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-08-11 05:37:56 -04:00
}
} ,
{
2024-01-10 06:35:44 -05:00
"name" : "size" ,
"in" : "path" ,
"description" : "The desired avatar size, e.g. 64 for 64x64px" ,
2023-08-11 05:37:56 -04:00
"required" : true ,
"schema" : {
2024-08-14 03:29:30 -04:00
"type" : "integer" ,
"format" : "int64" ,
"enum" : [
64 ,
512
]
2023-08-11 05:37:56 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Custom avatar returned" ,
2024-06-07 06:09:36 -04:00
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
2023-08-11 05:37:56 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"*/*" : {
2023-08-11 05:37:56 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string" ,
"format" : "binary"
2023-08-11 05:37:56 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"201" : {
"description" : "Avatar returned" ,
2024-06-07 06:09:36 -04:00
"headers" : {
"X-NC-IsCustomAvatar" : {
"schema" : {
"type" : "integer" ,
"format" : "int64"
}
}
} ,
2023-08-11 05:37:56 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"*/*" : {
2023-08-11 05:37:56 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string" ,
"format" : "binary"
2023-08-11 05:37:56 -04:00
}
}
}
} ,
"500" : {
2024-01-10 06:35:44 -05:00
"description" : ""
2023-08-11 05:37:56 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/login/confirm" : {
"post" : {
"operationId" : "login-confirm-password" ,
"summary" : "Confirm the user password" ,
2023-08-11 05:37:56 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"login"
2023-08-11 05:37:56 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"password"
] ,
"properties" : {
"password" : {
"type" : "string" ,
"description" : "The password of the user"
}
}
}
2023-08-11 05:37:56 -04:00
}
}
2024-07-02 03:08:04 -04:00
} ,
2023-08-11 05:37:56 -04:00
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Password confirmation succeeded" ,
2023-08-11 05:37:56 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"lastLogin"
2023-08-11 05:37:56 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"lastLogin" : {
"type" : "integer" ,
"format" : "int64"
2023-07-31 05:58:54 -04:00
}
}
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Password confirmation failed" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
2023-10-19 05:07:03 -04:00
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/ocm-provider" : {
2023-10-19 05:07:03 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "ocm-discovery" ,
"summary" : "generate a OCMProvider with local data and send it as DataResponse. This replaces the old PHP file ocm-provider/index.php" ,
2023-10-19 05:07:03 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"ocm"
2023-10-19 05:07:03 -04:00
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "OCM Provider details returned" ,
"headers" : {
"X-NEXTCLOUD-OCM-PROVIDERS" : {
"schema" : {
"type" : "boolean" ,
"enum" : [
true
]
}
}
} ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"enabled" ,
"apiVersion" ,
"endPoint" ,
"resourceTypes"
2023-10-19 05:07:03 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"enabled" : {
"type" : "boolean"
} ,
"apiVersion" : {
"type" : "string"
} ,
"endPoint" : {
"type" : "string"
} ,
"resourceTypes" : {
"type" : "array" ,
"items" : {
"type" : "object" ,
"required" : [
"name" ,
"shareTypes" ,
"protocols"
] ,
"properties" : {
"name" : {
"type" : "string"
} ,
"shareTypes" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"protocols" : {
"type" : "object" ,
"required" : [
"webdav"
] ,
"properties" : {
"webdav" : {
"type" : "string"
}
2023-10-19 05:07:03 -04:00
}
}
}
}
}
}
}
}
}
2024-01-10 06:35:44 -05:00
} ,
"500" : {
"description" : "OCM not supported" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/core/preview.png" : {
"get" : {
"operationId" : "preview-get-preview" ,
"summary" : "Get a preview by file path" ,
2023-10-19 05:07:03 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"preview"
2023-10-19 05:07:03 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-08-19 05:08:28 -04:00
"parameters" : [
{
"name" : "file" ,
"in" : "query" ,
"description" : "Path of the file" ,
"schema" : {
"type" : "string" ,
"default" : ""
}
} ,
{
"name" : "x" ,
"in" : "query" ,
"description" : "Width of the preview. A width of -1 will use the original image width." ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 32
}
} ,
{
"name" : "y" ,
"in" : "query" ,
"description" : "Height of the preview. A height of -1 will use the original image height." ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 32
}
} ,
{
"name" : "a" ,
"in" : "query" ,
"description" : "Preserve the aspect ratio" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "forceIcon" ,
"in" : "query" ,
"description" : "Force returning an icon" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : true
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "mode" ,
"in" : "query" ,
"description" : "How to crop the image" ,
"schema" : {
"type" : "string" ,
"default" : "fill" ,
"enum" : [
"fill" ,
"cover"
]
}
} ,
{
"name" : "mimeFallback" ,
"in" : "query" ,
"description" : "Whether to fallback to the mime icon if no preview is available" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-01-10 06:35:44 -05:00
}
}
2024-08-19 05:08:28 -04:00
] ,
2024-01-10 06:35:44 -05:00
"responses" : {
"200" : {
"description" : "Preview returned" ,
2023-10-19 05:07:03 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"*/*" : {
2023-10-19 05:07:03 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string" ,
"format" : "binary"
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"400" : {
"description" : "Getting preview is not possible" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
2023-10-19 05:07:03 -04:00
}
}
2023-10-20 07:33:05 -04:00
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Getting preview is not allowed" ,
2023-10-20 07:33:05 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
}
}
} ,
"404" : {
"description" : "Preview not found" ,
"content" : {
"application/json" : {
"schema" : { }
}
}
} ,
"303" : {
"description" : "Redirect to the mime icon url if mimeFallback is true" ,
"headers" : {
"Location" : {
2023-10-20 07:33:05 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-10-20 07:33:05 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/core/preview" : {
2023-10-19 05:07:03 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "preview-get-preview-by-file-id" ,
"summary" : "Get a preview by file ID" ,
2023-10-19 05:07:03 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"preview"
2023-10-19 05:07:03 -04:00
] ,
"security" : [
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-08-19 05:08:28 -04:00
"parameters" : [
{
"name" : "fileId" ,
"in" : "query" ,
"description" : "ID of the file" ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : -1
}
} ,
{
"name" : "x" ,
"in" : "query" ,
"description" : "Width of the preview. A width of -1 will use the original image width." ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 32
}
} ,
{
"name" : "y" ,
"in" : "query" ,
"description" : "Height of the preview. A height of -1 will use the original image height." ,
"schema" : {
"type" : "integer" ,
"format" : "int64" ,
"default" : 32
}
} ,
{
"name" : "a" ,
"in" : "query" ,
"description" : "Preserve the aspect ratio" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "forceIcon" ,
"in" : "query" ,
"description" : "Force returning an icon" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : true
2024-08-19 05:08:28 -04:00
}
} ,
{
"name" : "mode" ,
"in" : "query" ,
"description" : "How to crop the image" ,
"schema" : {
"type" : "string" ,
"default" : "fill" ,
"enum" : [
"fill" ,
"cover"
]
}
} ,
{
"name" : "mimeFallback" ,
"in" : "query" ,
"description" : "Whether to fallback to the mime icon if no preview is available" ,
"schema" : {
2025-09-01 10:03:07 -04:00
"type" : "boolean" ,
"default" : false
2023-10-19 05:07:03 -04:00
}
}
2024-08-19 05:08:28 -04:00
] ,
2023-10-19 05:07:03 -04:00
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Preview returned" ,
2023-10-19 05:07:03 -04:00
"content" : {
2024-01-10 06:35:44 -05:00
"*/*" : {
2023-10-19 05:07:03 -04:00
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string" ,
"format" : "binary"
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"400" : {
"description" : "Getting preview is not possible" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
2023-10-19 05:07:03 -04:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"403" : {
"description" : "Getting preview is not allowed" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
}
}
} ,
"404" : {
"description" : "Preview not found" ,
"content" : {
"application/json" : {
"schema" : { }
}
}
} ,
"303" : {
"description" : "Redirect to the mime icon url if mimeFallback is true" ,
"headers" : {
"Location" : {
"schema" : {
"type" : "string"
2023-10-19 05:07:03 -04:00
}
}
}
2025-08-26 04:21:10 -04:00
} ,
"401" : {
"description" : "Current user is not logged in" ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"message"
] ,
"properties" : {
"message" : {
"type" : "string"
}
}
}
}
}
2025-01-10 05:57:08 -05:00
}
}
}
} ,
"/index.php/core/mimeicon" : {
"get" : {
"operationId" : "preview-get-mime-icon-url" ,
"summary" : "Get a preview by mime" ,
"tags" : [
"preview"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
"name" : "mime" ,
"in" : "query" ,
"description" : "Mime type" ,
"schema" : {
"type" : "string" ,
"default" : "application/octet-stream"
}
}
] ,
"responses" : {
"303" : {
"description" : "The mime icon url" ,
"headers" : {
"Location" : {
"schema" : {
"type" : "string"
}
}
}
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/core/references/preview/{referenceId}" : {
2023-10-19 05:07:03 -04:00
"get" : {
2024-01-10 06:35:44 -05:00
"operationId" : "reference-preview" ,
"summary" : "Get a preview for a reference" ,
2023-10-19 05:07:03 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"reference"
2023-10-19 05:07:03 -04:00
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
"parameters" : [
{
2024-01-10 06:35:44 -05:00
"name" : "referenceId" ,
2023-10-20 07:33:05 -04:00
"in" : "path" ,
2024-01-10 06:35:44 -05:00
"description" : "the reference cache key" ,
2023-10-19 05:07:03 -04:00
"required" : true ,
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-10-19 05:07:03 -04:00
}
}
] ,
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Preview returned" ,
2023-10-19 05:07:03 -04:00
"content" : {
"*/*" : {
"schema" : {
"type" : "string" ,
"format" : "binary"
}
}
}
} ,
"404" : {
2024-01-10 06:35:44 -05:00
"description" : "Reference not found" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
"schema" : {
2024-01-10 06:35:44 -05:00
"type" : "string"
2023-10-19 05:07:03 -04:00
}
}
}
2024-01-10 06:35:44 -05:00
}
}
}
} ,
"/index.php/core/wipe/check" : {
"post" : {
"operationId" : "wipe-check-wipe" ,
"summary" : "Check if the device should be wiped" ,
"tags" : [
"wipe"
] ,
"security" : [
{ } ,
{
"bearer_auth" : [ ]
2023-10-19 05:07:03 -04:00
} ,
2024-01-10 06:35:44 -05:00
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"token"
] ,
"properties" : {
"token" : {
"type" : "string" ,
"description" : "App password"
}
}
}
2024-01-10 06:35:44 -05:00
}
}
2024-07-02 03:08:04 -04:00
} ,
2024-01-10 06:35:44 -05:00
"responses" : {
"200" : {
"description" : "Device should be wiped" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
2024-01-10 06:35:44 -05:00
"wipe"
2023-10-19 05:07:03 -04:00
] ,
"properties" : {
2024-01-10 06:35:44 -05:00
"wipe" : {
"type" : "boolean"
2023-10-19 05:07:03 -04:00
}
}
}
}
}
2024-01-10 06:35:44 -05:00
} ,
"404" : {
"description" : "Device should not be wiped" ,
"content" : {
"application/json" : {
"schema" : { }
}
}
2023-10-19 05:07:03 -04:00
}
}
}
} ,
2024-01-10 06:35:44 -05:00
"/index.php/core/wipe/success" : {
"post" : {
"operationId" : "wipe-wipe-done" ,
"summary" : "Finish the wipe" ,
2023-10-19 05:07:03 -04:00
"tags" : [
2024-01-10 06:35:44 -05:00
"wipe"
2023-10-19 05:07:03 -04:00
] ,
"security" : [
2024-01-10 06:35:44 -05:00
{ } ,
2023-10-19 05:07:03 -04:00
{
"bearer_auth" : [ ]
} ,
{
"basic_auth" : [ ]
}
] ,
2024-07-02 03:08:04 -04:00
"requestBody" : {
"required" : true ,
"content" : {
"application/json" : {
"schema" : {
"type" : "object" ,
"required" : [
"token"
] ,
"properties" : {
"token" : {
"type" : "string" ,
"description" : "App password"
}
}
}
2023-10-19 05:07:03 -04:00
}
}
2024-07-02 03:08:04 -04:00
} ,
2023-10-19 05:07:03 -04:00
"responses" : {
"200" : {
2024-01-10 06:35:44 -05:00
"description" : "Wipe finished successfully" ,
2023-10-19 05:07:03 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
2023-07-31 05:58:54 -04:00
}
}
} ,
2024-01-10 06:35:44 -05:00
"404" : {
"description" : "Device should not be wiped" ,
2023-07-31 05:58:54 -04:00
"content" : {
"application/json" : {
2024-01-10 06:35:44 -05:00
"schema" : { }
2023-05-24 10:34:27 -04:00
}
}
}
}
}
} ,
"/status.php" : {
"get" : {
"operationId" : "get-status" ,
"responses" : {
"200" : {
"description" : "Status returned" ,
"content" : {
"application/json" : {
"schema" : {
"$ref" : "#/components/schemas/Status"
}
}
}
}
}
}
}
} ,
"tags" : [
2025-09-30 08:36:32 -04:00
{
"name" : "ocs" ,
"description" : "If you are here because you can't extend the OCSController class, you got the wrong one. Please use {@see \\OCP\\AppFramework\\OCSController}!"
} ,
2023-05-24 10:34:27 -04:00
{
"name" : "avatar" ,
"description" : "Class AvatarController"
} ,
{
"name" : "guest_avatar" ,
"description" : "This controller handles guest avatar requests."
2023-09-05 08:42:48 -04:00
} ,
{
"name" : "ocm" ,
"description" : "Controller about the endpoint /ocm-provider/"
2025-12-18 05:12:23 -05:00
} ,
{
"name" : "open_metrics" ,
"description" : "OpenMetrics controller Gather and display metrics"
2023-05-24 10:34:27 -04:00
}
]
2024-07-02 03:08:04 -04:00
}
