OCS TextProcessing API

New in version 27.1.0.

The OCS Text processing API allows you to run text processing tasks, like prompting large language models implemented by apps using the backend Text Processing API.

The base URL for all calls to this API is: <nextcloud_base_url>/ocs/v2.php/textprocessing/

All calls to OCS endpoints require the OCS-APIRequest header to be set to true.

Get available task types

New in version 27.1.0.

• Method: GET

• Endpoint: /tasktypes

• Response:

  • Status code:

    • 200 OK

  • Data:

field	type	Description
types	array	A list of supported task types. See below.

Task type fields:

field	type	Description
name	string	The name of the task type in the user’s language
description	string	A description of the task type in the user’s language
id	string	The id of this task type

Schedule a task

New in version 28.

Note

The endpoint is rate limited as it can be quite resource intensive. Users can make 20 requests in 2 minutes, guests only 5

• Method: POST

• Endpoint: /schedule

• Data:

field	type	Description
input	string	The input text for the task
type	string	Id of this task’s type.
appId	string	The id of the requesting app
identifier	string	An app-defined identifier for the task

• Response:

  • Status code:

    • 200 OK

    • 400 Bad Request - When the task type is invalid

    • 412 Precondition Failed - When the task type is not available currently

    • 429 Too Many Requests - When the rate limiting was exceeded

  • Data:

    • input - Only provided in case of 200 OK, the task input, string

    • type - Only provided in case of 200 OK, the task type, string

    • id - Only provided in case of 200 OK, the assigned task id, int

    • status - Only provided in case of 200 OK, the current task status, int, see backend API

    • userId - Only provided in case of 200 OK, the originating userId of the task, string

    • appId - Only provided in case of 200 OK, the originating appId of the task, string

    • identifier - Only provided in case of 200 OK, the originating appId of the task, string

    • output - Only provided in case of 200 OK, the output from the model, string or null

    • message - Only provided when not 200 OK, an error message in the user’s language, ready to be displayed

Fetch a task by ID

New in version 28.

Note

The endpoint is rate limited as it can be quite resource intensive. Users can make 20 requests in 2 minutes, guests only 5

• Method: POST

• Endpoint: /task/{id}

• Response:

  • Status code:

    • 200 OK

    • 404 Not Found - When the task could not be found

  • Data:

    • input - Only provided in case of 200 OK, the task input, string

    • type - Only provided in case of 200 OK, the task type, string

    • id - Only provided in case of 200 OK, the assigned task id, int

    • status - Only provided in case of 200 OK, the current task status, int, see backend API

    • userId - Only provided in case of 200 OK, the originating userId of the task, string

    • appId - Only provided in case of 200 OK, the originating appId of the task, string

    • identifier - Only provided in case of 200 OK, the originating appId of the task, string

    • output - Only provided in case of 200 OK, the output from the model, string or null

    • message - Only provided when not 200 OK, an error message in the user’s language, ready to be displayed