Integration#

Base endpoint is: /ocs/v2.php/apps/spreed/api/v1: since Nextcloud 15

Get conversation for an internal file#

  • Method: GET
  • Endpoint: /file/{fileId}
  • Data:
field type Description
fileId int File id for which the conversation should be given
  • Response:

    • Status code:

      • 200 OK
      • 404 Not Found When the item was not found
      • 404 Not Found When the found item is not a file
      • 404 Not Found When the user can not access the file
      • 404 Not Found When the file is not shared with anyone
    • Data:

field type Description
token string The token of the conversation for this file

Get conversation for a public share#

  • Method: GET
  • Endpoint: /publicshare/{shareToken}
  • Data:
field type Description
shareToken string Share token for which the conversation should be given
  • Response:

    • Status code:

      • 200 OK
      • 404 Not Found When the share was not found
      • 404 Not Found When the user can not access the share
      • 404 Not Found When the shared item is not a file
    • Data:

field type Description
token string The token of the conversation for this file

Create a conversation to request the password for a public share#

  • Method: POST
  • Endpoint: /publicshareauth
  • Data:
field type Description
shareToken string Share token for which the conversation should be given
  • Response:

    • Status code:

      • 200 OK
      • 404 Not Found When the share was not found
      • 404 Not Found When "Request password via Talk" is not active for the share
    • Data:

field type Description
token string The token of the conversation for this file
name string A technical name for the conversation
displayName string The visual name of the conversation