1. Overview

This document describes the resources that make up the Clinked API v2. If you have any problems or requests please contact Clinked support.

The current version of the API was initially designed for internal use and might expose more data than necessary for most use cases.

1.1. Schema

All API access is over HTTPS, and accessed from the https://api-p1.clinked.com. All data is sent and received as JSON.

Blank fields are included as null instead of being omitted.

All timestamps are in milliseconds (UTC):

1518170699654

1.2. User agent

A client should provide a User-Agent header that can help identify your application. This allows us to contact you if there are problems.

Here’s an example:

User-Agent: Awesome-App

1.3. Authentication

Authentication flow is based on OAuth2 with a few additional steps:

  1. A client authenticates using static client id clinked-mobile and user credentials.

  2. Once authenticated, a client creates a new application using an access token from the previous step.

  3. Once application is created, the API responds with a new randomly generated client id and client secret. These credentials need to be persisted to refresh access token in the future.

  4. A client uses client id and client secret from previous step to authenticate.

The resulting access token is the one that is required to access API resources. Pass it in the Authorization header for each request:

Authorization: Bearer 1da13d89-150c-4c4d-a1a3-36958a7cd551
See our Basics of authentication guide to get you started.
Access token is temporary and available only for 30 minutes, after that the API will respond with 401 Unauthorized. If that’s the case a client should request a new one using same client id and client secret.
A user might revoke an application and the API will respond with 401 Unauthorized even when trying to refresh a token. In that case a user should be considered logged out.

1.3.1. Authenticating with user credentials

Table 1. Request parameters
Parameter Description

client_id

Client id. Always a static value for this grant type: clinked-mobile

grant_type

Grant type

password

Password

username

Username

code

Optional. Two-factor authentication code if required

Example of a request
GET /oauth/token?client_id=clinked-mobile&grant_type=password&password=Aez1Ahr8Ji&username=jack&code=12345 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/oauth/token?client_id=clinked-mobile&grant_type=password&password=Aez1Ahr8Ji&username=jack&code=12345' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

{
    "access_token": "f3a5837f-7a28-4148-9352-336e0bca75a9",
    "refresh_token": "e10560b0-9bdc-478e-a2dc-95009c419a40",
    "scope": "read write",
    "token_type": "bearer"
}

1.3.2. Creating an application

Table 2. Request fields
Path Type Description

deviceType

String

Device type: [Phone, Tablet, Watch, Browser, Other]

appVersion

String

Version

name

String

Name

bundleId

String

Bundle/package name

description

String

Description

deviceModel

String

Device model name

deviceToken

String

Device Firebase Cloud Messaging token for notifications

platform

String

Device platform: [IOS, ANDROID, SYNC, LINUX, WINDOWS, OTHER]

deviceOs

String

Device operating system name

Example of a request
POST /v2/applications HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 307

{
  "deviceType" : "Phone",
  "appVersion" : "1.0",
  "deviceOs" : "Android",
  "name" : "Awesome App",
  "bundleId" : "com.clinked.awesome",
  "description" : "This is my awesome app",
  "deviceModel" : "Google Pixel XL",
  "platform" : "ANDROID",
  "deviceToken" : "9b9fd357-715d-45c2-a92a-a38233a12101"
}
$ curl 'https://api-p1.clinked.com/v2/applications' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "deviceType" : "Phone",
  "appVersion" : "1.0",
  "deviceOs" : "Android",
  "name" : "Awesome App",
  "bundleId" : "com.clinked.awesome",
  "description" : "This is my awesome app",
  "deviceModel" : "Google Pixel XL",
  "platform" : "ANDROID",
  "deviceToken" : "9b9fd357-715d-45c2-a92a-a38233a12101"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1472

{
  "id" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "clientId" : "79df4f5fb1e6437a36456aeea5bb5242",
  "clientSecret" : "c637f44fd9c34753af2dbe1b7396c30d",
  "scope" : [ "read", "write", "smartsync" ],
  "name" : "Awesome App",
  "description" : "This is my awesome app",
  "platform" : "ANDROID",
  "deviceType" : "Phone",
  "deviceModel" : "Google Pixel XL",
  "deviceOs" : "Android",
  "appVersion" : "1.0",
  "bundleId" : "com.clinked.awesome",
  "deviceToken" : "9b9fd357-715d-45c2-a92a-a38233a12101",
  "lastActivity" : null,
  "ip" : null,
  "authorities" : [ {
    "authority" : "ROLE_CLIENT"
  } ],
  "registeredRedirectUri" : [ ]
}
Fields are defined in Get single application

1.3.3. Authenticating with client credentials

Table 3. Request parameters
Parameter Description

client_id

Client id

client_secret

Client secret

grant_type

Grant type

scope

Scope. Normally should be read write

Example of a request
GET /oauth/token?client_id=5ad29f13-82b8-4b68-89e6-c2f4c96d5d9d&client_secret=0eda391b-0a88-46d2-aaaf-905332c19e20&grant_type=client_credentials&scope=read+write HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/oauth/token?client_id=5ad29f13-82b8-4b68-89e6-c2f4c96d5d9d&client_secret=0eda391b-0a88-46d2-aaaf-905332c19e20&grant_type=client_credentials&scope=read+write' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

{
    "access_token": "2466f2ee-0875-41a1-ad6c-8f81468f47e9",
    "token_type": "bearer",
    "expires_in": 7199,
    "scope": "read write"
}

1.5. Rate limit

The overview documentation describes the rate limit rules. You can check your current rate limit status at any time using the Rate Limit API described below.

1.5.1. Get your current rate limit status

Accessing this endpoint does not count against your rate limit.
Example of a request
GET /v2/rates HTTP/1.1
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/rates' -i
Example of a success response
HTTP/1.1 200 OK
X-RateLimit-Limit: 50
X-RateLimit-Remaining: 37
Content-Type: application/json;charset=UTF-8
Content-Length: 38

{
  "limit" : 50,
  "remaining" : 37
}

2. Organisation

Organisation (sometimes referred as an "account") is a holder for multiple groups. You need to know id of an organisation to use the following resources.

2.1. Data

Organisation holds data such as package and customizations.

2.1.1. List organisations

This resource returns a list of organisations user is part of.

Example of a request
GET /v2/accounts HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1656

[ {
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "creator" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "name" : "awesome_org",
  "friendlyName" : "Awesome Organisation",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "enabled" : true,
  "domain" : null,
  "mobileSchema" : null,
  "branding" : {
    "backgroundColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "logoLarge" : false,
    "logoMedium" : false,
    "background" : false,
    "favicon" : false,
    "textLogo" : false,
    "gradient" : false,
    "gradientWidth" : 400
  },
  "samlConfiguration" : {
    "entityId" : null,
    "ssoEnabled" : false,
    "userJit" : true,
    "forceSso" : false,
    "adminsUsePassword" : true,
    "disableProfileEdit" : false
  },
  "hash" : null,
  "type" : "account"
} ]
List item fields are defined in Get a single organisation data

2.1.2. Get a single organisation data

View extended details for an organisation.

Table 4. /v2/accounts/{organisation}
Parameter Description

organisation

Organisation/account id

Example of a request
GET /v2/accounts/1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1652

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "creator" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "name" : "awesome_org",
  "friendlyName" : "Awesome Organisation",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "enabled" : true,
  "domain" : null,
  "mobileSchema" : null,
  "branding" : {
    "backgroundColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "logoLarge" : false,
    "logoMedium" : false,
    "background" : false,
    "favicon" : false,
    "textLogo" : false,
    "gradient" : false,
    "gradientWidth" : 400
  },
  "samlConfiguration" : {
    "entityId" : null,
    "ssoEnabled" : false,
    "userJit" : true,
    "forceSso" : false,
    "adminsUsePassword" : true,
    "disableProfileEdit" : false
  },
  "hash" : null,
  "type" : "account"
}
Table 5. Definition of the returned fields
Path Type Description

id

Number

Organisation id

creator

Object

Creator user

name

String

Unique name

friendlyName

String

Full name

dateCreated

Number

Creation date

lastModified

Number

Last modification date

enabled

Boolean

Is account enabled

samlConfiguration

Object

SAML configuration

branding.backgroundColor

String

Branding background color

branding.textColor

String

Branding text color

branding.logo

Boolean

Has logo

branding.logoLarge

Boolean

Has large size logo

branding.logoMedium

Boolean

Has medium size logo

branding.favicon

Boolean

Has custom favicon

branding.gradient

Boolean

Has gradient applied to background image

branding.gradientWidth

Number

The horizontal width of the gradient over the background image

2.1.3. Get custom component names

Some organisations require naming customisations.

Table 6. /v2/accounts/{organisation}/custom
Parameter Description

organisation

Organisation/account id

Example of a request
GET /v2/accounts/1/custom HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/custom' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 385

{
  "naming.files.plural" : "Files",
  "naming.files.singular" : "File",
  "naming.discussions.plural" : "Discussions",
  "naming.tasks.plural" : "Tasks",
  "naming.pages.singular" : "Note",
  "naming.pages.plural" : "Notes",
  "naming.events.singular" : "Event",
  "naming.tasks.singular" : "Task",
  "naming.discussions.singular" : "Discussion",
  "naming.events.plural" : "Events"
}
Table 7. Definition of the returned fields
Path Type Description

naming.events.singular

String

Events component singular name

naming.discussions.singular

String

Discussions component singular name

naming.files.singular

String

Files component singular name

naming.pages.singular

String

Notes component singular name

naming.tasks.singular

String

Tasks component singular name

naming.events.plural

String

Events component plural name

naming.discussions.plural

String

Discussions component plural name

naming.files.plural

String

Files component plural name

naming.pages.plural

String

Notes component plural name

naming.tasks.plural

String

Tasks component plural name

2.2. Groups

2.2.1. List groups

View list of all organisation groups.

Table 8. /v2/accounts/{organisation}/groups
Parameter Description

organisation

Organisation/account id

Example of a request
GET /v2/accounts/1/groups HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3355

[ {
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "members" : 0,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "published" : false,
  "defaultPublic" : false,
  "storageConsumed" : 0,
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "mailKey" : null,
  "order" : null,
  "hash" : null,
  "blind" : false,
  "disableChat" : false,
  "disableWidgets" : false,
  "disableComments" : false,
  "disableAccordionWidgets" : true,
  "duplicate" : false,
  "public" : false,
  "type" : "group",
  "account" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "creator" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "awesome_org",
    "friendlyName" : "Awesome Organisation",
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "enabled" : true,
    "domain" : null,
    "mobileSchema" : null,
    "branding" : {
      "backgroundColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "logoLarge" : false,
      "logoMedium" : false,
      "background" : false,
      "favicon" : false,
      "textLogo" : false,
      "gradient" : false,
      "gradientWidth" : 400
    },
    "samlConfiguration" : {
      "entityId" : null,
      "ssoEnabled" : false,
      "userJit" : true,
      "forceSso" : false,
      "adminsUsePassword" : true,
      "disableProfileEdit" : false
    },
    "hash" : null,
    "type" : "account"
  }
} ]
List item fields are defined in Get a single group data

2.2.2. Get a single group data

View extended details for a single group.

Table 9. /v2/accounts/{organisation}/groups/{space}
Parameter Description

organisation

Organisation/account id

space

Space/group id

Example of a request
GET /v2/accounts/1/groups/1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3351

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "members" : 0,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "published" : false,
  "defaultPublic" : false,
  "storageConsumed" : 0,
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "mailKey" : null,
  "order" : null,
  "hash" : null,
  "blind" : false,
  "disableChat" : false,
  "disableWidgets" : false,
  "disableComments" : false,
  "disableAccordionWidgets" : true,
  "duplicate" : false,
  "public" : false,
  "type" : "group",
  "account" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "creator" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "awesome_org",
    "friendlyName" : "Awesome Organisation",
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "enabled" : true,
    "domain" : null,
    "mobileSchema" : null,
    "branding" : {
      "backgroundColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "logoLarge" : false,
      "logoMedium" : false,
      "background" : false,
      "favicon" : false,
      "textLogo" : false,
      "gradient" : false,
      "gradientWidth" : 400
    },
    "samlConfiguration" : {
      "entityId" : null,
      "ssoEnabled" : false,
      "userJit" : true,
      "forceSso" : false,
      "adminsUsePassword" : true,
      "disableProfileEdit" : false
    },
    "hash" : null,
    "type" : "account"
  }
}
Table 10. Definition of the returned fields
Path Type Description

id

Number

Group id

owner

Object

Owner user

name

String

Group unique name

friendlyName

String

Group friendly name

members

Number

Amount of group members

branding.headerColor

String

Header background color

branding.textColor

String

Text color

branding.logo

Boolean

Logo exists

branding.alignment

String

Logo alignment

storageConsumed

Number

Amount of storage consumed

dateCreated

Number

Creation date

lastModified

Number

Last modification time

disableChat

Boolean

Chat disabled

disableWidgets

Boolean

Home widgets disabled

disableComments

Boolean

Content comments disabled

disableAccordionWidgets

Boolean

Recent, Created by, I follow widgets disabled

account

Object

Organisation/account a group belongs to

2.2.3. Create a group

Creates a new group for an organisation.

Table 11. /v2/accounts/{organisation}/groups
Parameter Description

organisation

Organisation/account id

Table 12. Request fields
Path Type Description

name

String

Group unique name

friendlyName

String

Group friendly name

branding.headerColor

String

Header background color

branding.textColor

String

Text color

branding.logo

Boolean

Logo exists

branding.alignment

String

Logo alignment

disableChat

Boolean

Chat disabled

disableWidgets

Boolean

Home widgets disabled

disableComments

Boolean

Content comments disabled

disableAccordionWidgets

Boolean

Recent, Created by, I follow widgets disabled

components

Array

Enabled components

Example of a request
POST /v2/accounts/1/groups HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 423

{
  "disableAccordionWidgets" : false,
  "components" : [ "activity", "files", "pages", "discussions", "events", "tasks", "chat", "dashboards" ],
  "disableChat" : false,
  "disableWidgets" : false,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "disableComments" : false
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "disableAccordionWidgets" : false,
  "components" : [ "activity", "files", "pages", "discussions", "events", "tasks", "chat", "dashboards" ],
  "disableChat" : false,
  "disableWidgets" : false,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "disableComments" : false
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 709

{
  "id" : null,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "owner" : null,
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "members" : 0,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "published" : false,
  "defaultPublic" : false,
  "storageConsumed" : 0,
  "dateCreated" : null,
  "lastModified" : null,
  "mailKey" : null,
  "order" : null,
  "hash" : null,
  "blind" : false,
  "disableChat" : false,
  "disableWidgets" : false,
  "disableComments" : false,
  "disableAccordionWidgets" : false,
  "duplicate" : false,
  "public" : false,
  "type" : "group",
  "account" : null
}
Response fields are defined in Get a single group data

2.2.4. Update a group

Changing group data and settings.

Table 13. /v2/accounts/{organisation}/groups/{space}
Parameter Description

organisation

Organisation/account id

space

Space/group id

Example of a request
POST /v2/accounts/1/groups/1 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 423

{
  "disableAccordionWidgets" : false,
  "components" : [ "activity", "files", "pages", "discussions", "events", "tasks", "chat", "dashboards" ],
  "disableChat" : false,
  "disableWidgets" : false,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "disableComments" : false
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "disableAccordionWidgets" : false,
  "components" : [ "activity", "files", "pages", "discussions", "events", "tasks", "chat", "dashboards" ],
  "disableChat" : false,
  "disableWidgets" : false,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "disableComments" : false
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3352

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "members" : 0,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "published" : false,
  "defaultPublic" : false,
  "storageConsumed" : 0,
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "mailKey" : null,
  "order" : null,
  "hash" : null,
  "blind" : false,
  "disableChat" : false,
  "disableWidgets" : false,
  "disableComments" : false,
  "disableAccordionWidgets" : false,
  "duplicate" : false,
  "public" : false,
  "type" : "group",
  "account" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "creator" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "awesome_org",
    "friendlyName" : "Awesome Organisation",
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "enabled" : true,
    "domain" : null,
    "mobileSchema" : null,
    "branding" : {
      "backgroundColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "logoLarge" : false,
      "logoMedium" : false,
      "background" : false,
      "favicon" : false,
      "textLogo" : false,
      "gradient" : false,
      "gradientWidth" : 400
    },
    "samlConfiguration" : {
      "entityId" : null,
      "ssoEnabled" : false,
      "userJit" : true,
      "forceSso" : false,
      "adminsUsePassword" : true,
      "disableProfileEdit" : false
    },
    "hash" : null,
    "type" : "account"
  }
}
Response fields are defined in Get a single group data

2.2.5. Delete a group

Removes a single group by placing it to trash.

Table 14. /v2/accounts/{organisation}/groups/{space}
Parameter Description

organisation

Organisation/account id

space

Space/group id

Example of a request
DELETE /v2/accounts/1/groups/1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1' -i -X DELETE -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK

2.2.6. Duplicate group

Duplicates a group.

Table 15. /v2/accounts/{organisation}/groups/{space}/duplicate
Parameter Description

organisation

Organisation/account id

space

Space/group id

Request fields

Unresolved directive in index.adoc - include::/home/ec2-user/clinked/clinked-api-webapp/target/generated-snippets/v2/groups/duplicate/request-fields.adoc[]

Example of a request
GET /v2/accounts/1/groups/1/duplicate?duplicateName=New+Group+Name HTTP/1.1
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/duplicate?duplicateName=New+Group+Name' -i
Example of a success response
HTTP/1.1 202 Accepted

2.3. Members

Administrator permission is required to manage organisation members.

2.3.1. List members

List of current organisation members. Result is paginated.

Table 16. /v2/accounts/{organisation}/members
Parameter Description

organisation

Organisation/account id

Table 17. Request parameters
Parameter Description

page

The page to retrieve

pageSize

Entries per page

Example of a request
GET /v2/accounts/1/members HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/members' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1111

{
  "currentPage" : 1,
  "totalResults" : 1,
  "pageSize" : 10,
  "page" : [ {
    "user" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "accountPermission" : 1
  } ],
  "nextPage" : false,
  "previousPage" : false,
  "totalPages" : 1
}
Table 18. Definition of the returned fields
Path Type Description

currentPage

Number

Current page

pageSize

Number

Entries per page

nextPage

Boolean

Next page exists

page

Array

Page entries

totalPages

Number

Total amount of available pages

nextPage

Boolean

Next page exists

previousPage

Boolean

Previous page exists

totalResults

Number

Total amount of entries

Page entry fields are defined in Get single member data.

2.3.2. Get single member data

Single member data.

Table 19. /v2/accounts/{organisation}/members/{username}
Parameter Description

organisation

Organisation/account id

username

Username of a user to retrieve

Example of a request
GET /v2/accounts/1/members/jack HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/members/jack' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 892

{
  "user" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "accountPermission" : 1
}
Table 20. Definition of the returned fields
Path Type Description

user.id

Number

User id

user.username

String

Unique username

user.address

String

Address

user.name

String

Full name

user.email

String

E-mail address

user.enabled

Boolean

Enabled and can sign in

user.telephone

String

Phone number

user.organisation

String

Organisation name user works in

user.jobTitle

String

Job title

user.locked

Boolean

Locked and can’t sign in

user.twoFactorAuthentication

Boolean

2FA is enabled

user.twoFactorMode

String

2FA mode - either SMS or Authenticator

user.lastModified

Number

Last modification date (timestamp in milliseconds)

user.lastLogin

Number

Last sign in date (timestamp in milliseconds)

user.dateActivated

Number

Activation date (timestamp in milliseconds)

user.dateCreated

Number

Creation date (timestamp in milliseconds)

user.timeZone

String

Local time zone name

user.timeZoneOffset

Number

Local time zone offset

user.locale

String

Locale

user.verifiedEmail

Boolean

Is E-mail address verified

accountPermission

Number

Account permission mask

groups

Object

Map of group:permission

2.3.3. Create a member

Single member creation. This example also adds newly created user to a group named my_group with read, write & create permissions.

Table 21. /v2/accounts/{organisation}/members
Parameter Description

organisation

Organisation/account id

Table 22. Request fields
Path Type Description

user.username

String

Unique username

user.password

String

Raw password

user.address

String

Address

user.name

String

Full name

user.email

String

E-mail address

user.enabled

String

Enabled and can sign in

user.telephone

String

Phone number

user.organisation

String

Organisation name user works in

user.jobTitle

String

Job title

accountPermission

Number

Account permission mask

groups

Object

Map of group:permission

Example of a request
POST /v2/accounts/1/members HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 208

{
  "user" : {
    "username" : "jack",
    "password" : "iuWo9oog1I",
    "name" : "Jack Bauer",
    "email" : "jack.bauer@clinked.com"
  },
  "accountPermission" : 4,
  "groups" : {
    "my_group" : 1
  }
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/members' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "user" : {
    "username" : "jack",
    "password" : "iuWo9oog1I",
    "name" : "Jack Bauer",
    "email" : "jack.bauer@clinked.com"
  },
  "accountPermission" : 4,
  "groups" : {
    "my_group" : 1
  }
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 892

{
  "user" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "accountPermission" : 0
}
Table 23. Definition of the returned fields
Path Type Description

user.id

Number

User id

user.username

String

Unique username

user.address

String

Address

user.name

String

Full name

user.email

String

E-mail address

user.enabled

Boolean

Enabled and can sign in

user.telephone

String

Phone number

user.organisation

String

Organisation name user works in

user.jobTitle

String

Job title

user.locked

Boolean

Locked and can’t sign in

user.twoFactorAuthentication

Boolean

2FA is enabled

user.twoFactorMode

String

2FA mode - either SMS or Authenticator

user.lastModified

Number

Last modification date (timestamp in milliseconds)

user.lastLogin

Number

Last sign in date (timestamp in milliseconds)

user.dateActivated

Number

Activation date (timestamp in milliseconds)

user.dateCreated

Number

Creation date (timestamp in milliseconds)

user.timeZone

String

Local time zone name

user.timeZoneOffset

Number

Local time zone offset

user.locale

String

Locale

user.verifiedEmail

Boolean

Is E-mail address verified

accountPermission

Number

Account permission mask

2.3.4. Update a member

Changing member data.

Table 24. /v2/accounts/{organisation}/members/{username}
Parameter Description

organisation

Organisation/account id

username

Username of a user to update

Table 25. Request fields
Path Type Description

user.username

String

Unique username

user.password

String

Raw password

user.address

String

Address

user.name

String

Full name

user.email

String

E-mail address

user.enabled

String

Enabled and can sign in

user.telephone

String

Phone number

user.organisation

String

Organisation name user works in

user.jobTitle

String

Job title

accountPermission

Number

Account permission mask

groups

Object

Map of group:permission

Example of a request
POST /v2/accounts/1/members/jack HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 324

{
  "user" : {
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "enabled" : true,
    "password" : "iuWo9oog1I",
    "name" : "name",
    "email" : "valid@email.local"
  },
  "accountPermission" : 1,
  "groups" : {
    "my_group" : 1
  }
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/members/jack' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "user" : {
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "enabled" : true,
    "password" : "iuWo9oog1I",
    "name" : "name",
    "email" : "valid@email.local"
  },
  "accountPermission" : 1,
  "groups" : {
    "my_group" : 1
  }
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 881

{
  "user" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "name",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "valid@email.local",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "accountPermission" : 1
}
Table 26. Definition of the returned fields
Path Type Description

user.id

Number

User id

user.username

String

Unique username

user.address

String

Address

user.name

String

Full name

user.email

String

E-mail address

user.enabled

Boolean

Enabled and can sign in

user.telephone

String

Phone number

user.organisation

String

Organisation name user works in

user.jobTitle

String

Job title

user.locked

Boolean

Locked and can’t sign in

user.twoFactorAuthentication

Boolean

2FA is enabled

user.twoFactorMode

String

2FA mode - either SMS or Authenticator

user.lastModified

Number

Last modification date (timestamp in milliseconds)

user.lastLogin

Number

Last sign in date (timestamp in milliseconds)

user.dateActivated

Number

Activation date (timestamp in milliseconds)

user.dateCreated

Number

Creation date (timestamp in milliseconds)

user.timeZone

String

Local time zone name

user.timeZoneOffset

Number

Local time zone offset

user.locale

String

Locale

user.verifiedEmail

Boolean

Is E-mail address verified

accountPermission

Number

Account permission mask

groups

Object

Map of group:permission

2.3.5. Delete a member

Deleting a member. If a user has no organisations any more it will be automatically deleted from the system.

Deleted user can’t be restored.
Table 27. /v2/accounts/{organisation}/members/{username}
Parameter Description

organisation

Organisation/account id

username

Username of a user to delete

Example of a request
DELETE /v2/accounts/1/members/jack HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/members/jack' -i -X DELETE -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK

3. Group

A group (sometimes referred as "space") is an isolated entity that belongs to an organisation. Each group has its own content such as files, notes, etc.

3.1. Files

3.1.1. List files

List visible files in a group folder. Result is paginated.

Table 28. Request parameters
Parameter Description

page

The page to retrieve

pageSize

Entries per page

order.name

Order by name

order.lastModified

Order by modification date

order.size

Order by size

condition.name

Search by name

modifiedSince

Retrieve files that were modified after the date (timestamp in milliseconds)

folder

Retrieve folders only (excludes other files)

Top level folder

Uploads a file to the group top level folder.

Table 29. /v2/accounts/{organisation}/groups/{space}/files
Parameter Description

organisation

Organisation/account id

space

Space/group id

Example of a request
GET /v2/accounts/1/groups/1/files HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 11090

{
  "currentPage" : 1,
  "pageSize" : 25,
  "nextPage" : false,
  "page" : [ {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "name" : "example_folder",
    "friendlyName" : "Example Folder",
    "contentType" : "@folder",
    "size" : 0,
    "uploaded" : {
      "user" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "Jack Bauer"
    },
    "versions" : 0,
    "sharing" : "NONE",
    "memberPermission" : 2,
    "hidden" : false,
    "tags" : null,
    "locked" : false,
    "locker" : null,
    "dateLocked" : null,
    "lastModified" : null,
    "previewInfo" : null,
    "inputStream" : null,
    "path" : null,
    "available" : true,
    "type" : "file",
    "parent" : null,
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  }, {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "name" : "file_example.pdf",
    "friendlyName" : "File Example.pdf",
    "contentType" : "application/pdf",
    "size" : 1000,
    "uploaded" : {
      "user" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "Jack Bauer"
    },
    "versions" : 0,
    "sharing" : "NONE",
    "memberPermission" : 2,
    "hidden" : false,
    "tags" : "tag1,tag2",
    "locked" : false,
    "locker" : null,
    "dateLocked" : null,
    "lastModified" : 1514764800000,
    "previewInfo" : null,
    "inputStream" : null,
    "path" : null,
    "available" : true,
    "type" : "file",
    "parent" : null,
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  } ]
}
Table 30. Definition of the returned fields
Path Type Description

currentPage

Number

Current page

pageSize

Number

Entries per page

nextPage

Boolean

Next page exists

page

Array

Page entries

Page entry fields are defined in Get a single file data.
Specific folder
Table 31. /v2/accounts/{organisation}/groups/{space}/files/{folder}/children
Parameter Description

organisation

Organisation/account id

space

Space/group id

folder

Folder id to get files from, empty for root directory

Example of a request
GET /v2/accounts/1/groups/1/files/1/children HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/1/children' -i -H 'Accept: application/json'

Result is the same as in Top level folder.

3.1.2. Get a single file data

Single file might contain more data about a file that is not present when retrieving a list.

Table 32. /v2/accounts/{organisation}/groups/{space}/files/{file}
Parameter Description

organisation

Organisation/account id

space

Space/group id

file

File id to retrieve

Example of a request
GET /v2/accounts/1/groups/1/files/1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5134

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "file_example.pdf",
  "friendlyName" : "File Example.pdf",
  "contentType" : "application/pdf",
  "size" : 1000,
  "uploaded" : {
    "user" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "Jack Bauer"
  },
  "versions" : 0,
  "sharing" : "NONE",
  "memberPermission" : 2,
  "hidden" : false,
  "tags" : "tag1,tag2",
  "locked" : false,
  "locker" : null,
  "dateLocked" : null,
  "lastModified" : 1514764800000,
  "previewInfo" : null,
  "inputStream" : null,
  "path" : [ ],
  "available" : true,
  "type" : "file",
  "parent" : null,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Table 33. Definition of the returned fields
Path Type Description

id

Number

File id

comments

Number

name

String

Unique file name, generated automatically by API

friendlyName

String

Full file name that should be visible to a user

contentType

String

Content type

size

Number

Size in bytes

uploaded

Object

User who uploaded a file

versions

Number

Number of versions

sharing

String

Sharing option, determines who can see a file: [NONE, DEFAULT, MEMBERS, PUBLIC]

memberPermission

Number

Member file permission mask

hidden

Boolean

Is hidden

tags

String

Tags separated by comma

lastModified

Number

Last modification date (timestamp in milliseconds)

parent

Object

File parent folder

group

Object

A group to which file belongs to

3.1.3. Upload a file

Large files

This method allows to upload a file by small chunks and is preferred because it is more reliable since most often a potential file size is unknown when developing a client application. Also this method doesn’t create a file until a client informs the API about successful upload.

Table 34. /v2/accounts/{organisation}/groups/{space}/files/upload/data
Parameter Description

organisation

Organisation/account id

space

Space/group id

Table 35. Request headers
Name Description

X-File-Name

File full name

X-File-Type

File content type

X-File-Size

File full size

X-File-Id

File id

X-File-Chunk

Chunk index

X-File-Start

Chunk start

X-File-End

Chunk end

Example of a request (chunk #1)
POST /v2/accounts/1/groups/1/files/upload/data HTTP/1.1
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
X-File-Name: Lorem ipsum.txt
X-File-Type: text/plain
X-File-Size: 138
X-File-Id: 0
X-File-Chunk: 0
X-File-Start: 0
X-File-End: 67
Host: api-p1.clinked.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vitae.
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/upload/data' -i -X POST -H 'Content-Type: multipart/form-data' -H 'X-File-Name: Lorem ipsum.txt' -H 'X-File-Type: text/plain' -H 'X-File-Size: 138' -H 'X-File-Id: 0' -H 'X-File-Chunk: 0' -H 'X-File-Start: 0' -H 'X-File-End: 67' -F 'file=Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed vitae.'
Example of a request (chunk #2)
POST /v2/accounts/1/groups/1/files/upload/data HTTP/1.1
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
X-File-Name: Lorem ipsum.txt
X-File-Type: text/plain
X-File-Size: 138
X-File-Id: 0
X-File-Chunk: 1
X-File-Start: 67
X-File-End: 138
Host: api-p1.clinked.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file

Nulla facilisi. Etiam dignissim libero id diam facilisis, vel volutpat.
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/upload/data' -i -X POST -H 'Content-Type: multipart/form-data' -H 'X-File-Name: Lorem ipsum.txt' -H 'X-File-Type: text/plain' -H 'X-File-Size: 138' -H 'X-File-Id: 0' -H 'X-File-Chunk: 1' -H 'X-File-Start: 67' -H 'X-File-End: 138' -F 'file=Nulla facilisi. Etiam dignissim libero id diam facilisis, vel volutpat.'
Example of a success response
HTTP/1.1 200 OK

When all file chunks are uploaded a client should inform the API about successful upload, specify where to put the uploaded file and provide file metadata in the request body.

Table 36. Request headers
Name Description

X-File-Name

File full name

X-File-Type

File content type

X-File-Size

File full size

X-File-Id

File id

Table 37. Request parameters
Parameter Description

success

Mark upload as successful

forwardContext

Where to put successfully uploaded file in the following format: /v2/accounts/{organisation}/groups/{space}/files/{folder}. The {folder} parameter is optional, if it’s blank a file will be uploaded to the group top level folder.

Table 38. Request fields
Path Type Description

friendlyName

String

Full file name

contentType

String

File type

size

Number

File size

sharing

String

Sharing option, determines who can see a file: [NONE, DEFAULT, MEMBERS, PUBLIC]

memberPermission

Number

Member file permission mask

Example of a request
POST /v2/accounts/1/groups/1/files/upload/complete?success=true&forwardContext=%2Fv2%2Faccounts%2F1%2Fgroups%2F1%2Ffiles HTTP/1.1
Content-Type: application/json
X-File-Name: Lorem ipsum.txt
X-File-Type: text/plain
X-File-Size: 138
X-File-Id: 0
Host: api-p1.clinked.com
Content-Length: 139

{
  "memberPermission" : 8,
  "size" : 138,
  "sharing" : "MEMBERS",
  "contentType" : "text/plain",
  "friendlyName" : "Lorem ipsum.txt"
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/upload/complete?success=true&forwardContext=%2Fv2%2Faccounts%2F1%2Fgroups%2F1%2Ffiles' -i -X POST -H 'Content-Type: application/json' -H 'X-File-Name: Lorem ipsum.txt' -H 'X-File-Type: text/plain' -H 'X-File-Size: 138' -H 'X-File-Id: 0' -d '{
  "memberPermission" : 8,
  "size" : 138,
  "sharing" : "MEMBERS",
  "contentType" : "text/plain",
  "friendlyName" : "Lorem ipsum.txt"
}'
Example of a success response
HTTP/1.1 200 OK
Small files
We encourage clients to upload a file by chunks as described in the Large files section as it is more reliable method in most cases.

This method allows to upload small files (less than 100MB). If a file is larger than that please refer to Large files section.

There are 2 steps you need to do to upload a file using this method:

  1. Create a new File instance by providing information such as file size and type.

  2. Upload file contents with single request.

Create file instance

Before you upload a file you need to provide some data about it by creating a File instance.

Table 39. /v2/accounts/{organisation}/groups/{space}/files/{folder}
Parameter Description

organisation

Organisation/account id

space

Space/group id

folder

Optional. Folder id to create file in, empty for root directory

Table 40. Request fields
Path Type Description

friendlyName

String

Full file name

contentType

String

File content type

size

Number

File size

id

Number

Existing file id to update

sharing

String

Sharing option, determines who can see a file: [NONE, DEFAULT, MEMBERS, PUBLIC]

memberPermission

Number

Member file permission mask

Example of a request
POST /v2/accounts/1/groups/1/files/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Authorization:
Host: api-p1.clinked.com
Content-Length: 145

{
  "memberPermission" : 8,
  "size" : 1000,
  "sharing" : "MEMBERS",
  "contentType" : "application/pdf",
  "friendlyName" : "My Document.pdf"
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Authorization: ' -d '{
  "memberPermission" : 8,
  "size" : 1000,
  "sharing" : "MEMBERS",
  "contentType" : "application/pdf",
  "friendlyName" : "My Document.pdf"
}'
Response fields are the same as defined in Get a single file data.
Upload file data
Table 41. /v2/accounts/{organisation}/groups/{space}/files/{file}/data
Parameter Description

organisation

Organisation/account id

space

Space/group id

file

File id

Example of a request
POST /v2/accounts/1/groups/1/files/1/data HTTP/1.1
Content-Type: multipart/form-data; boundary=6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Host: api-p1.clinked.com

--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm
Content-Disposition: form-data; name=file

Lorem ipsum dolor sit amet, consectetur adipiscing elit. In fringilla.
--6o2knFse3p53ty9dmcQvWAIx1zInP11uCfbm--
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/1/data' -i -X POST -H 'Content-Type: multipart/form-data' -F 'file=Lorem ipsum dolor sit amet, consectetur adipiscing elit. In fringilla.'
Example of a success response
HTTP/1.1 200 OK

3.1.4. Create a folder

Table 42. /v2/accounts/{organisation}/groups/{space}/files/{folder}
Parameter Description

organisation

Organisation/account id

space

Space/group id

folder

Optional. Folder id to create folder in, empty for root directory

Table 43. Request fields
Path Type Description

friendlyName

String

Full folder name

contentType

String

Content type as '@folder'

size

Number

Size as '0'

id

Number

Existing folder id to update

sharing

String

Sharing option, determines who can see a file: [NONE, DEFAULT, MEMBERS, PUBLIC]

memberPermission

Number

Member file permission mask

Example of a request
POST /v2/accounts/1/groups/1/files/ HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 128

{
  "memberPermission" : 8,
  "size" : 0,
  "sharing" : "MEMBERS",
  "contentType" : "@folder",
  "friendlyName" : "My Folder"
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "memberPermission" : 8,
  "size" : 0,
  "sharing" : "MEMBERS",
  "contentType" : "@folder",
  "friendlyName" : "My Folder"
}'
Response fields are the same as defined in Get a single file data.

3.1.5. Remove a file

When removing a file it is placed to a group trash can and may be restored.

When removing a folder that contains files it is a client responsibility to recursively remove all files before removing a folder itself to avoid possible data loss because internal files are not automatically moved to a group trash can.
Table 44. /v2/accounts/{organisation}/groups/{space}/files/{file}
Parameter Description

organisation

Organisation/account id

space

Space/group id

file

File id to remove

Example of a request
DELETE /v2/accounts/1/groups/1/files/1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/1' -i -X DELETE -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK

3.1.6. Move a file

Moves a file to other groups and folders.

Table 45. /v2/accounts/{organisation}/groups/{space}/files/{file}/move
Parameter Description

organisation

Organisation/account id

space

Space/group id

file

File id to move

Table 46. Request fields
Path Type Description

id

Number

Destination folder id, or null for group top level directory

group.id

Number

Destination group id

Example of a request
POST /v2/accounts/1/groups/1/files/1/move HTTP/1.1
Content-Type: application/json
Host: api-p1.clinked.com
Content-Length: 46

{
  "id" : 5,
  "group" : {
    "id" : 1
  }
}
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/1/move' -i -X POST -H 'Content-Type: application/json' -d '{
  "id" : 5,
  "group" : {
    "id" : 1
  }
}'
Response fields are the same as defined in Get a single file data.

3.1.7. Download a file

Table 47. /v2/accounts/{organisation}/groups/{space}/files/{file}/download
Parameter Description

organisation

Organisation/account id

space

Space/group id

file

File id to download

Example of a request
GET /v2/accounts/1/groups/1/files/1/download HTTP/1.1
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/accounts/1/groups/1/files/1/download' -i
Example of a success response
HTTP/1.1 200 OK

3.2. Notes

API does not support note deletion yet.

3.2.1. List notes

View list of all organisation notes.

Table 48. /groups/{group}/pages
Parameter Description

group

Group name or @id

Table 49. Request parameters
Parameter Description

type

Type: page, template, dashboard

condition.name

Search by name

orderBy

Order field

ascending

Order ascending

currentPage

Page number to retrieve

Example of a request
GET /groups/@1/pages?type=page&orderBy=lastModified&ascending=false&currentPage=1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/pages?type=page&orderBy=lastModified&ascending=false&currentPage=1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5345

{
  "currentPage" : 1,
  "totalResults" : 1,
  "pageSize" : 1,
  "page" : [ {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "name" : "home_page",
    "friendlyName" : "Home Page",
    "moved" : null,
    "template" : false,
    "tags" : "",
    "content" : "",
    "creator" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "sharing" : "MEMBERS",
    "memberPermission" : 8,
    "type" : "page",
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  } ],
  "nextPage" : false,
  "previousPage" : false,
  "totalPages" : 1
}
Table 50. Definition of the returned fields
Path Type Description

page

Array

Page items

nextPage

Boolean

Next page exists

previousPage

Boolean

Previous page exists

currentPage

Number

Current page number

pageSize

Number

Page size

totalPages

Number

Total amount of pages

totalResults

Number

Total amount of matching items

3.2.2. Get a single note data

View extended details for a single note.

Table 51. /groups/{group}/pages/{note}
Parameter Description

group

Group name or @id

note

Note name or @id

Example of a request
GET /groups/@1/pages/@1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/pages/@1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5107

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "home_page",
  "friendlyName" : "Home Page",
  "moved" : null,
  "template" : false,
  "tags" : "",
  "content" : "",
  "creator" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "sharing" : "MEMBERS",
  "memberPermission" : 8,
  "editContent" : "<h2>Welcome to your Group Welcome Note!</h2><p><strong>This is a sample note to help you explore Clinked.</strong>",
  "viewContent" : "<h2>Welcome to your Group Welcome Note!</h2><p><strong>This is a sample note to help you explore Clinked.</strong>",
  "type" : "page",
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Table 52. Definition of the returned fields
Path Type Description

id

Number

Id

comments

Number

Amount of comments

attachments

Number

Amount of attachments

name

String

Unique name

friendlyName

String

Full name

template

Boolean

Is a template

tags

String

Tags

content

String

Contents

creator

Object

Creator

dateCreated

Number

Creation date

lastModified

Number

Last modification date

sharing

String

Permission

memberPermission

Number

Permission mask

editContent

String

Content for editing

viewContent

String

Content for viewing

group

Object

Owner group

3.2.3. Create a note

Creates a new note for an organisation.

Table 53. /groups/{group}/pages
Parameter Description

group

Group name or @id

Table 54. Request fields
Path Type Description

friendlyName

String

Note name

content

String

Note content

Example of a request
POST /groups/@1/pages HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 64

{
  "friendlyName" : "Home page",
  "content" : "<p>Hello</p>"
}
$ curl 'https://api-p1.clinked.com/groups/@1/pages' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "friendlyName" : "Home page",
  "content" : "<p>Hello</p>"
}'
Example of a success response
HTTP/1.1 201 Created
Content-Type: application/json;charset=UTF-8
Content-Length: 4021

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "home_page",
  "friendlyName" : "Home page",
  "moved" : null,
  "template" : false,
  "tags" : null,
  "content" : "",
  "creator" : null,
  "dateCreated" : null,
  "lastModified" : null,
  "sharing" : "MEMBERS",
  "memberPermission" : 8,
  "editContent" : null,
  "viewContent" : null,
  "type" : "page",
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Response fields are defined in Get a single note data

3.2.4. Update a note

Changing note data and settings.

Table 55. /groups/{group}/pages/{note}
Parameter Description

group

Group name or @id

note

Note name or @id

Example of a request
POST /groups/@1/pages/@1 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 64

{
  "friendlyName" : "Home page",
  "content" : "<p>Hello</p>"
}
$ curl 'https://api-p1.clinked.com/groups/@1/pages/@1' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "friendlyName" : "Home page",
  "content" : "<p>Hello</p>"
}'
Example of a success response
HTTP/1.1 200 OK

3.3. Events

3.3.1. List events in date range

Retrieves all events in a date range.

Table 56. /groups/{group}/events/range
Parameter Description

group

Group name or @id

Table 57. Request parameters
Parameter Description

start

Range start date in ISO 8601

end

Range end date in ISO 8601

Example of a request
GET /groups/@1/events/range?start=2018-01-01T00%3A00%3A00Z&end=2018-02-01T00%3A00%3A00Z HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/events/range?start=2018-01-01T00%3A00%3A00Z&end=2018-02-01T00%3A00%3A00Z' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5164

[ {
  "id" : 1,
  "comments" : 5,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "meeting_with_a_client",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000,
  "endDate" : 1515164400000,
  "allDay" : false,
  "location" : "London",
  "tags" : "",
  "description" : "Let's do this every friday",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "dateReminder" : 1514707200000,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "attendees" : 5,
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "timeZone" : "Etc/UTC",
  "dateEndRecurrence" : null,
  "disableMaybe" : false,
  "memberPermission" : 2,
  "multiDay" : false,
  "type" : "event",
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
} ]
List item fields are defined in Get a single event data

3.3.2. Get a single event data

View extended details for a single event.

Table 58. /groups/{group}/events/{event}
Parameter Description

group

Group name or @id

event

Event name or @id

Example of a request
GET /groups/@1/events/@1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/events/@1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5256

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "meeting_with_a_client",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000,
  "endDate" : 1515164400000,
  "allDay" : false,
  "location" : "London",
  "tags" : "",
  "description" : "Let's do this every friday",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "dateReminder" : 1514707200000,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "attendees" : 5,
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "timeZone" : "Etc/UTC",
  "dateEndRecurrence" : null,
  "disableMaybe" : false,
  "editContent" : "Let's do this every friday",
  "viewContent" : "Let's do this every friday",
  "type" : "event",
  "memberPermission" : 2,
  "multiDay" : false,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Table 59. Definition of the returned fields
Path Type Description

id

Number

Id

comments

Number

Amount of comments

attachments

Number

Amount of attachments

name

String

Unique name

friendlyName

String

Full name

startDate

Number

Start date and time

endDate

Number

End date and time

allDay

Boolean

Full day event

location

String

Location

tags

String

Tags

description

String

Description

editContent

String

Description optimized for editing

viewContent

String

Description optimized for viewing

dateCreated

Number

Creation date

lastModified

Number

Last modification date

dateReminder

Number

Remind date

author

Object

Creator

attendees

Number

Amount of attendees

recurrence

String

Recurrence rule (iCal)

dateEndRecurrence

Number

Recurrence end date

timeZone

String

Event time zone id

disableMaybe

Boolean

May attend attendee status is disabled

multiDay

Boolean

Is recurrent event

memberPermission

Number

Member permission

group

Object

Group

3.3.3. Create an event

Creates a new event.

Table 60. /groups/{group}/events
Parameter Description

group

Group name or @id

Table 61. Request fields
Path Type Description

friendlyName

String

Full name

description

String

Description

startDate

Number

Start date and time

endDate

Number

End date and time

allDay

Boolean

Is all day event

location

String

Location

dateReminder

Number

When to remind event attendees about the event via e-mail

recurrence

String

Recurrence rule (iCal)

dateEndRecurrence

Number

Recurrence end date

timeZone

String

Event time zone id

Example of a request
POST /groups/@1/events HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 338

{
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "allDay" : false,
  "dateReminder" : 1514707200000,
  "endDate" : 1515164400000,
  "dateEndRecurrence" : null,
  "description" : "Let's do this every friday",
  "timeZone" : "Etc/UTC",
  "location" : "London",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000
}
$ curl 'https://api-p1.clinked.com/groups/@1/events' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "allDay" : false,
  "dateReminder" : 1514707200000,
  "endDate" : 1515164400000,
  "dateEndRecurrence" : null,
  "description" : "Let's do this every friday",
  "timeZone" : "Etc/UTC",
  "location" : "London",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5256

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "meeting_with_a_client",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000,
  "endDate" : 1515164400000,
  "allDay" : false,
  "location" : "London",
  "tags" : "",
  "description" : "Let's do this every friday",
  "dateCreated" : 1544053191868,
  "lastModified" : 1544053191868,
  "dateReminder" : 1514707200000,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "attendees" : 0,
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "timeZone" : "Etc/UTC",
  "dateEndRecurrence" : null,
  "disableMaybe" : false,
  "editContent" : "Let's do this every friday",
  "viewContent" : "Let's do this every friday",
  "type" : "event",
  "memberPermission" : 2,
  "multiDay" : false,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Response fields are defined in Get a single event data

3.3.4. Update an event

Changing event data.

Table 62. /groups/{group}/events/{event}
Parameter Description

group

Group name or @id

event

Event name or @id

Example of a request
PUT /groups/@1/events/@1 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 338

{
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "allDay" : false,
  "dateReminder" : 1514707200000,
  "endDate" : 1515164400000,
  "dateEndRecurrence" : null,
  "description" : "Let's do this every friday",
  "timeZone" : "Etc/UTC",
  "location" : "London",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000
}
$ curl 'https://api-p1.clinked.com/groups/@1/events/@1' -i -X PUT -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "allDay" : false,
  "dateReminder" : 1514707200000,
  "endDate" : 1515164400000,
  "dateEndRecurrence" : null,
  "description" : "Let's do this every friday",
  "timeZone" : "Etc/UTC",
  "location" : "London",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5256

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "meeting_with_a_client",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000,
  "endDate" : 1515164400000,
  "allDay" : false,
  "location" : "London",
  "tags" : "",
  "description" : "Let's do this every friday",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "dateReminder" : 1514707200000,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "attendees" : 5,
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "timeZone" : "Etc/UTC",
  "dateEndRecurrence" : null,
  "disableMaybe" : false,
  "editContent" : "Let's do this every friday",
  "viewContent" : "Let's do this every friday",
  "type" : "event",
  "memberPermission" : 2,
  "multiDay" : false,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5256

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "meeting_with_a_client",
  "friendlyName" : "Meeting with a client",
  "startDate" : 1515160800000,
  "endDate" : 1515164400000,
  "allDay" : false,
  "location" : "London",
  "tags" : "",
  "description" : "Let's do this every friday",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "dateReminder" : 1514707200000,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "attendees" : 5,
  "recurrence" : "FREQ=WEEKLY;WKST=MO;BYDAY=FR",
  "timeZone" : "Etc/UTC",
  "dateEndRecurrence" : null,
  "disableMaybe" : false,
  "editContent" : "Let's do this every friday",
  "viewContent" : "Let's do this every friday",
  "type" : "event",
  "memberPermission" : 2,
  "multiDay" : false,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Response fields are defined in Get a single event data

3.3.5. Delete an event

Deleting event.

Table 63. /groups/{group}/events/{event}
Parameter Description

group

Group name or @id

event

Event name or @id

Example of a request
DELETE /groups/@1/events/@1 HTTP/1.1
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/events/@1' -i -X DELETE
Example of a success response
HTTP/1.1 200 OK

3.4. Tasks

3.4.1. List tasks

Retrieves all tasks in a date range.

Table 64. /groups/{group}/tasks
Parameter Description

group

Group name or @id

Table 65. Request parameters
Parameter Description

completed

Include completed tasks

orderBy

Order field

ascending

Order ascending

currentPage

Page number to retrieve

Example of a request
GET /groups/@1/tasks?completed=true&orderBy=dateCreated&ascending=false&currentPage=1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/tasks?completed=true&orderBy=dateCreated&ascending=false&currentPage=1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5697

{
  "currentPage" : 1,
  "totalResults" : 1,
  "pageSize" : 1,
  "page" : [ {
    "id" : 1,
    "comments" : 5,
    "attachments" : 0,
    "contextKey" : null,
    "category" : null,
    "name" : "deploy_update",
    "friendlyName" : "Deploy update",
    "status" : "NOT_STARTED",
    "progress" : 0,
    "datePriority" : 0,
    "dueDate" : null,
    "tags" : "",
    "description" : "Let's do this",
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "dateReminder" : 1514707200000,
    "author" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "sharing" : "MEMBERS",
    "recurrence" : null,
    "recurId" : null,
    "timeZone" : null,
    "order" : 2147483647,
    "memberPermission" : 1,
    "overdue" : false,
    "summary" : "explore_clinked: Deploy update",
    "timeSet" : false,
    "completed" : false,
    "type" : "task",
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  } ],
  "nextPage" : false,
  "previousPage" : false,
  "totalPages" : 1
}
List item fields are defined in Get a single task data

3.4.2. Get a single task data

View extended details for a single task.

Table 66. /groups/{group}/tasks/{task}
Parameter Description

group

Group name or @id

task

Task name or @id

Example of a request
GET /groups/@1/tasks/@1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/tasks/@1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5233

{
  "id" : 1,
  "comments" : 5,
  "attachments" : 0,
  "contextKey" : null,
  "category" : null,
  "name" : "deploy_update",
  "friendlyName" : "Deploy update",
  "status" : "NOT_STARTED",
  "progress" : 0,
  "datePriority" : 0,
  "dueDate" : null,
  "tags" : "",
  "description" : "Let's do this",
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "dateReminder" : 1514707200000,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "recurrence" : null,
  "recurId" : null,
  "timeZone" : null,
  "order" : 2147483647,
  "editContent" : "Let's do this",
  "viewContent" : "Let's do this",
  "type" : "task",
  "memberPermission" : 1,
  "overdue" : false,
  "summary" : "explore_clinked: Deploy update",
  "timeSet" : false,
  "completed" : false,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Table 67. Definition of the returned fields
Path Type Description

id

Number

Id

comments

Number

Amount of comments

attachments

Number

Amount of attachments

name

String

Unique name

friendlyName

String

Full name

status

String

Status

progress

Number

Progress in %

datePriority

Number

Priority

tags

String

Tags

description

String

Description

editContent

String

Description optimized for editing

viewContent

String

Description for viewing

dateCreated

Number

Creation date

lastModified

Number

Last modification date

dateReminder

Number

Reminder date

author

Object

Creator

timeZone

String

Task time zone id

timeSet

Boolean

Is time set

completed

Boolean

Is completed

overdue

Boolean

Is task overdue

summary

String

Summary text

group

Object

Owner group

category

Object

Task category

order

Number

Task order from smallest to largest

3.4.3. Create a task

Creates a new task.

Table 68. /groups/{group}/tasks
Parameter Description

group

Group name or @id

Table 69. Request fields
Path Type Description

friendlyName

String

Full name

description

String

Description

status

String

Status: [NOT_STARTED, IN_PROGRESS, DEFERRED, WAITING, COMPLETED]

dateReminder

Number

Reminder date

dueDate

Number

Deadline

progress

Number

Completion progress in %

Example of a request
POST /groups/@1/tasks HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 184

{
  "dateReminder" : 1544053192208,
  "dueDate" : 1544053192208,
  "description" : "Do this",
  "progress" : 50,
  "friendlyName" : "Deploy latest update",
  "status" : "IN_PROGRESS"
}
$ curl 'https://api-p1.clinked.com/groups/@1/tasks' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "dateReminder" : 1544053192208,
  "dueDate" : 1544053192208,
  "description" : "Do this",
  "progress" : 50,
  "friendlyName" : "Deploy latest update",
  "status" : "IN_PROGRESS"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5255

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "category" : null,
  "name" : "deploy_latest_update",
  "friendlyName" : "Deploy latest update",
  "status" : "IN_PROGRESS",
  "progress" : 50,
  "datePriority" : 2,
  "dueDate" : 1544053192208,
  "tags" : "",
  "description" : "Do this",
  "dateCreated" : 1544053192242,
  "lastModified" : 1544053192242,
  "dateReminder" : 1544053192208,
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "sharing" : "MEMBERS",
  "recurrence" : null,
  "recurId" : null,
  "timeZone" : "Europe/London",
  "order" : 2147483647,
  "editContent" : "Do this",
  "viewContent" : "Do this",
  "type" : "task",
  "memberPermission" : 1,
  "overdue" : true,
  "summary" : "explore_clinked: Deploy latest update",
  "timeSet" : true,
  "completed" : false,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Response fields are defined in Get a single task data

3.4.4. Update a task

Changing task data.

include::/home/ec2-user/clinked/clinked-api-webapp/target/generated-snippets/groups/id/tasks/update/path

3.5. Discussions

3.5.1. List discussions

Table 70. /groups/{group}/discussions
Parameter Description

group

Group name or @id

Example of a request
GET /groups/@1/discussions HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/discussions' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 5394

{
  "currentPage" : 1,
  "totalResults" : 1,
  "pageSize" : 1,
  "page" : [ {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "name" : "great_discussion",
    "friendlyName" : "Great discussion",
    "tags" : "",
    "description" : "What do you think about this?",
    "replies" : 5,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "sharing" : "MEMBERS",
    "author" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "replier" : null,
    "memberPermission" : 2,
    "type" : "discussion",
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  } ],
  "nextPage" : false,
  "previousPage" : false,
  "totalPages" : 1
}
Table 71. Definition of the returned fields
Path Type Description

page

Array

Page items

nextPage

Boolean

Next page exists

previousPage

Boolean

Previous page exists

currentPage

Number

Current page number

pageSize

Number

Page size

totalPages

Number

Total amount of pages

totalResults

Number

Total amount of matching items

3.5.2. Get a single discussion

Table 72. /groups/{group}/discussions/{discussion}
Parameter Description

group

Group name or @id

discussion

Discussion name or @id

Example of a request
GET /groups/@1/discussions/@1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/discussions/@1' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 4986

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "great_discussion",
  "friendlyName" : "Great discussion",
  "tags" : "",
  "description" : "What do you think about this?",
  "replies" : 5,
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "sharing" : "MEMBERS",
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "replier" : null,
  "editContent" : "What do you think about this?",
  "viewContent" : "What do you think about this?",
  "type" : "discussion",
  "memberPermission" : 2,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Table 73. Definition of the returned fields
Path Type Description

id

Number

Id

replies

Number

Amount of replies

dateCreated

Number

Creation date

lastModified

Number

Last modification date

author

Object

Author

memberPermission

Number

Member permission

group

Object

Group

name

String

Unique name

friendlyName

String

Full name

tags

String

Tags

description

String

Description

editContent

String

Description optimized for editing

viewContent

String

Description optimized for viewing

sharing

String

Permission

3.5.3. Create a discussion

Table 74. /groups/{group}/discussions
Parameter Description

group

Group name or @id

Table 75. Request fields
Path Type Description

friendlyName

String

Name

description

String

Description

Example of a request
POST /groups/@1/discussions HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 77

{
  "description" : "What do you think?",
  "friendlyName" : "Discuss this"
}
$ curl 'https://api-p1.clinked.com/groups/@1/discussions' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "description" : "What do you think?",
  "friendlyName" : "Discuss this"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 4945

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "name" : "discuss_this",
  "friendlyName" : "Discuss this",
  "tags" : "",
  "description" : "What do you think?",
  "replies" : 0,
  "dateCreated" : 1544053191570,
  "lastModified" : 1544053191570,
  "sharing" : "MEMBERS",
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "replier" : null,
  "editContent" : "What do you think?",
  "viewContent" : "What do you think?",
  "type" : "discussion",
  "memberPermission" : 2,
  "group" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "owner" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "explore_clinked",
    "friendlyName" : "Explore Clinked",
    "members" : 0,
    "branding" : {
      "headerColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "alignment" : "left"
    },
    "published" : false,
    "defaultPublic" : false,
    "storageConsumed" : 0,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "mailKey" : null,
    "order" : null,
    "hash" : null,
    "blind" : false,
    "disableChat" : false,
    "disableWidgets" : false,
    "disableComments" : false,
    "disableAccordionWidgets" : true,
    "duplicate" : false,
    "public" : false,
    "type" : "group",
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    }
  }
}
Table 76. Definition of the returned fields
Path Type Description

id

Number

Id

replies

Number

Amount of replies

dateCreated

Number

Creation date

lastModified

Number

Last modification date

author

Object

Author

memberPermission

Number

Member permission

group

Object

Group

name

String

Unique name

friendlyName

String

Full name

tags

String

Tags

description

String

Description

editContent

String

Description optimized for editing

viewContent

String

Description optimized for viewing

sharing

String

Permission

3.5.4. List discussion replies

Table 77. /groups/{group}/discussions/{discussion}/replies
Parameter Description

group

Group name or @id

discussion

Discussion name or @id

Example of a request
GET /groups/@1/discussions/@1/replies HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/discussions/@1/replies' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 6318

[ {
  "id" : 1,
  "discussion" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "name" : "great_discussion",
    "friendlyName" : "Great discussion",
    "tags" : "",
    "description" : "What do you think about this?",
    "replies" : 5,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "sharing" : "MEMBERS",
    "author" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "replier" : null,
    "memberPermission" : 2,
    "type" : "discussion",
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  },
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "reply" : "Here are my 2 cents",
  "dateCreated" : 1514764800000,
  "silent" : false,
  "editContent" : "Here are my 2 cents",
  "viewContent" : "Here are my 2 cents"
} ]
Table 78. Definition of the returned fields
Path Type Description

[].id

Number

Id

[].discussion

Object

Discussion

[].author

Object

Author

[].reply

String

Reply text

[].dateCreated

Number

Creation date

[].editContent

String

Reply text for editing

[].viewContent

String

Reply text optimized for viewing

3.5.5. Create discussion reply

Table 79. /groups/{group}/discussions/{discussion}/replies
Parameter Description

group

Group name or @id

discussion

Discussion name or @id

Table 80. Request fields
Path Type Description

reply

String

Reply text

Example of a request
POST /groups/@1/discussions/@1/replies HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 37

{
  "reply" : "Here are my 2 cents"
}
$ curl 'https://api-p1.clinked.com/groups/@1/discussions/@1/replies' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "reply" : "Here are my 2 cents"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 6314

{
  "id" : 1,
  "discussion" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "name" : "great_discussion",
    "friendlyName" : "Great discussion",
    "tags" : "",
    "description" : "What do you think about this?",
    "replies" : 5,
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "sharing" : "MEMBERS",
    "author" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "replier" : null,
    "memberPermission" : 2,
    "type" : "discussion",
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  },
  "author" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "reply" : "Here are my 2 cents",
  "dateCreated" : 1544053191473,
  "silent" : false,
  "editContent" : "Here are my 2 cents",
  "viewContent" : "Here are my 2 cents"
}
Table 81. Definition of the returned fields
Path Type Description

id

Number

Id

discussion

Object

Discussion

author

Object

Author

reply

String

Reply text

editContent

String

Reply text optimized for editing

viewContent

String

Reply text optimized for viewing

dateCreated

Number

Creation date

3.5.6. Delete discussion reply

Table 82. /groups/{group}/discussions/{discussion}/replies/@{reply}
Parameter Description

group

Group name or @id

discussion

Discussion name or @id

reply

Reply id

Example of a request
DELETE /groups/@1/discussions/@1/replies/@1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups/@1/discussions/@1/replies/@1' -i -X DELETE -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK

3.6. Activity

Activity is a list of events called "updates". Each update has a type that should be mapped to a template which is populated by additional data. Example template:

{0} uploaded file {3} in {2}

A template can contain one of the following placeholders:

Placeholder number Data

0

Username

1

Organisation name

2

Group name

3

Component name

4

Target username

5

Reserved name

For a list of all type → template mappings see Appendix D: Update templates.

3.6.1. List group updates

Retrieves a list of of group updates. Result is paginated.

Table 83. /v2/updates/group/{space}
Parameter Description

space

Space/group id

Table 84. Request parameters
Parameter Description

offset

Pagination offset

Example of a request
GET /v2/updates/group/1 HTTP/1.1
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/updates/group/1' -i
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 7549

{
  "offset" : "1c373bfc-2ad7-475d-889d-b9d1ff4e257f",
  "items" : [ {
    "id" : "8049f86b-3677-416d-a5b9-d02bb8513ea3",
    "messageCode" : "update.space.trash.filerecord.create",
    "message" : null,
    "lastModified" : 1514764800000,
    "organisationId" : 1,
    "spaceId" : 1,
    "componentId" : 1,
    "componentEntityId" : 1,
    "userId" : 1,
    "targetUserId" : null,
    "componentName" : "Picture 2017-09-28 22-09-58.jpg",
    "reservedName" : null,
    "userName" : "Jack Bauer",
    "targetUserName" : null,
    "users" : [ ],
    "trackingUsers" : [ ],
    "attachments" : [ ],
    "published" : false,
    "commentCount" : 0,
    "component" : null,
    "user" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "targetUser" : null,
    "type" : "update",
    "accountName" : null,
    "groupName" : null,
    "account" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "creator" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "awesome_org",
      "friendlyName" : "Awesome Organisation",
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "enabled" : true,
      "domain" : null,
      "mobileSchema" : null,
      "branding" : {
        "backgroundColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "logoLarge" : false,
        "logoMedium" : false,
        "background" : false,
        "favicon" : false,
        "textLogo" : false,
        "gradient" : false,
        "gradientWidth" : 400
      },
      "samlConfiguration" : {
        "entityId" : null,
        "ssoEnabled" : false,
        "userJit" : true,
        "forceSso" : false,
        "adminsUsePassword" : true,
        "disableProfileEdit" : false
      },
      "hash" : null,
      "type" : "account"
    },
    "group" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : null,
      "owner" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : {
          "id" : null,
          "parent" : null,
          "objectType" : "com.rabbitsoft.clinked.domain.User",
          "objectId" : 1
        },
        "username" : "jack",
        "enabled" : true,
        "locked" : false,
        "twoFactorAuthentication" : false,
        "lastModified" : 1514764800000,
        "lastLogin" : 1514764800000,
        "dateCreated" : 1514764800000,
        "dateActivated" : 1514764800000,
        "name" : "Jack Bauer",
        "jobTitle" : "Marketing",
        "organisation" : "Clinked",
        "email" : "jack.bauer@clinked.com",
        "address" : "71 Pilgrim Avenue",
        "telephone" : "123456789",
        "other" : null,
        "logo" : false,
        "timeZone" : "Etc/UTC",
        "locale" : "en",
        "verifiedEmail" : false,
        "twoFactorMode" : null,
        "timeZoneOffset" : 0,
        "type" : "user"
      },
      "name" : "explore_clinked",
      "friendlyName" : "Explore Clinked",
      "members" : 0,
      "branding" : {
        "headerColor" : "#ffffff",
        "textColor" : "#ff0000",
        "logo" : false,
        "alignment" : "left"
      },
      "published" : false,
      "defaultPublic" : false,
      "storageConsumed" : 0,
      "dateCreated" : 1514764800000,
      "lastModified" : 1514764800000,
      "mailKey" : null,
      "order" : null,
      "hash" : null,
      "blind" : false,
      "disableChat" : false,
      "disableWidgets" : false,
      "disableComments" : false,
      "disableAccordionWidgets" : true,
      "duplicate" : false,
      "public" : false,
      "type" : "group",
      "account" : {
        "id" : 1,
        "comments" : 0,
        "attachments" : 0,
        "contextKey" : null,
        "creator" : {
          "id" : 1,
          "comments" : 0,
          "attachments" : 0,
          "contextKey" : {
            "id" : null,
            "parent" : null,
            "objectType" : "com.rabbitsoft.clinked.domain.User",
            "objectId" : 1
          },
          "username" : "jack",
          "enabled" : true,
          "locked" : false,
          "twoFactorAuthentication" : false,
          "lastModified" : 1514764800000,
          "lastLogin" : 1514764800000,
          "dateCreated" : 1514764800000,
          "dateActivated" : 1514764800000,
          "name" : "Jack Bauer",
          "jobTitle" : "Marketing",
          "organisation" : "Clinked",
          "email" : "jack.bauer@clinked.com",
          "address" : "71 Pilgrim Avenue",
          "telephone" : "123456789",
          "other" : null,
          "logo" : false,
          "timeZone" : "Etc/UTC",
          "locale" : "en",
          "verifiedEmail" : false,
          "twoFactorMode" : null,
          "timeZoneOffset" : 0,
          "type" : "user"
        },
        "name" : "awesome_org",
        "friendlyName" : "Awesome Organisation",
        "dateCreated" : 1514764800000,
        "lastModified" : 1514764800000,
        "enabled" : true,
        "domain" : null,
        "mobileSchema" : null,
        "branding" : {
          "backgroundColor" : "#ffffff",
          "textColor" : "#ff0000",
          "logo" : false,
          "logoLarge" : false,
          "logoMedium" : false,
          "background" : false,
          "favicon" : false,
          "textLogo" : false,
          "gradient" : false,
          "gradientWidth" : 400
        },
        "samlConfiguration" : {
          "entityId" : null,
          "ssoEnabled" : false,
          "userJit" : true,
          "forceSso" : false,
          "adminsUsePassword" : true,
          "disableProfileEdit" : false
        },
        "hash" : null,
        "type" : "account"
      }
    }
  } ],
  "more" : true
}
Table 85. Definition of the returned fields
Path Type Description

offset

String

Pagination offset

items

Array

Page items

more

Boolean

Has next page

items[].id

String

Id

items[].messageCode

String

Message code

items[].message

String

Message text

items[].lastModified

Number

Last modification date

items[].organisationId

Number

Organisation id

items[].spaceId

Number

Group id

items[].componentId

Number

Component id

items[].componentEntityId

Number

Component entity id

items[].userId

Number

Uesr id

items[].targetUserId

Number

Target user id

items[].componentName

String

Component name

items[].reservedName

String

Reserved name

items[].userName

String

Username

items[].targetUserName

String

Target username

items[].attachments

Array

Attachments

items[].component

Object

Component

items[].user

Object

User

items[].targetUser

Object

Target user

3.6.2. List organisation updates

Retrieves a list of organisation updates. Result is paginated.

Table 86. /v2/updates/organisation/{organisation}
Parameter Description

organisation

Organisation/account id

Table 87. Request parameters
Parameter Description

offset

Pagination offset

Example of a request
GET /v2/updates/organisation/1 HTTP/1.1
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/updates/organisation/1' -i
Response example is the same as for List group updates.

3.7. Comments

Pending

3.8. Guests

Pending

4. User

Currently logged in user can retrieve and manage some of his own information.

4.1. Getting user data

Example of a request
GET /v2/users/me HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/users/me' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 786

{
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : {
    "id" : null,
    "parent" : null,
    "objectType" : "com.rabbitsoft.clinked.domain.User",
    "objectId" : 1
  },
  "username" : "jack",
  "enabled" : true,
  "locked" : false,
  "twoFactorAuthentication" : false,
  "lastModified" : 1514764800000,
  "lastLogin" : 1514764800000,
  "dateCreated" : 1514764800000,
  "dateActivated" : 1514764800000,
  "name" : "Jack Bauer",
  "jobTitle" : "Marketing",
  "organisation" : "Clinked",
  "email" : "jack.bauer@clinked.com",
  "address" : "71 Pilgrim Avenue",
  "telephone" : "123456789",
  "other" : null,
  "logo" : false,
  "timeZone" : "Etc/UTC",
  "locale" : "en",
  "verifiedEmail" : false,
  "twoFactorMode" : null,
  "timeZoneOffset" : 0,
  "type" : "user"
}
Table 88. Definition of the returned fields
Path Type Description

id

Number

User id

username

String

Unique username

address

String

Address

name

String

Full name

email

String

E-mail address

enabled

Boolean

Enabled and can sign in

telephone

String

Phone number

organisation

String

Organisation name user works in

jobTitle

String

Job title

locked

Boolean

Locked and can’t sign in

twoFactorAuthentication

Boolean

2FA is enabled

twoFactorMode

String

2FA mode - either SMS or Authenticator

lastModified

Number

Last modification date (timestamp in milliseconds)

lastLogin

Number

Last sign in date (timestamp in milliseconds)

dateActivated

Number

Activation date (timestamp in milliseconds)

dateCreated

Number

Creation date (timestamp in milliseconds)

timeZone

String

Local time zone name

timeZoneOffset

Number

Local time zone offset

locale

String

Locale

verifiedEmail

Boolean

Is E-mail address verified

4.2. List user groups

Retrieve all groups a user is a member of.

Example of a request
GET /groups HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/groups' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 3355

[ {
  "id" : 1,
  "comments" : 0,
  "attachments" : 0,
  "contextKey" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "name" : "explore_clinked",
  "friendlyName" : "Explore Clinked",
  "members" : 0,
  "branding" : {
    "headerColor" : "#ffffff",
    "textColor" : "#ff0000",
    "logo" : false,
    "alignment" : "left"
  },
  "published" : false,
  "defaultPublic" : false,
  "storageConsumed" : 0,
  "dateCreated" : 1514764800000,
  "lastModified" : 1514764800000,
  "mailKey" : null,
  "order" : null,
  "hash" : null,
  "blind" : false,
  "disableChat" : false,
  "disableWidgets" : false,
  "disableComments" : false,
  "disableAccordionWidgets" : true,
  "duplicate" : false,
  "public" : false,
  "type" : "group",
  "account" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : null,
    "creator" : {
      "id" : 1,
      "comments" : 0,
      "attachments" : 0,
      "contextKey" : {
        "id" : null,
        "parent" : null,
        "objectType" : "com.rabbitsoft.clinked.domain.User",
        "objectId" : 1
      },
      "username" : "jack",
      "enabled" : true,
      "locked" : false,
      "twoFactorAuthentication" : false,
      "lastModified" : 1514764800000,
      "lastLogin" : 1514764800000,
      "dateCreated" : 1514764800000,
      "dateActivated" : 1514764800000,
      "name" : "Jack Bauer",
      "jobTitle" : "Marketing",
      "organisation" : "Clinked",
      "email" : "jack.bauer@clinked.com",
      "address" : "71 Pilgrim Avenue",
      "telephone" : "123456789",
      "other" : null,
      "logo" : false,
      "timeZone" : "Etc/UTC",
      "locale" : "en",
      "verifiedEmail" : false,
      "twoFactorMode" : null,
      "timeZoneOffset" : 0,
      "type" : "user"
    },
    "name" : "awesome_org",
    "friendlyName" : "Awesome Organisation",
    "dateCreated" : 1514764800000,
    "lastModified" : 1514764800000,
    "enabled" : true,
    "domain" : null,
    "mobileSchema" : null,
    "branding" : {
      "backgroundColor" : "#ffffff",
      "textColor" : "#ff0000",
      "logo" : false,
      "logoLarge" : false,
      "logoMedium" : false,
      "background" : false,
      "favicon" : false,
      "textLogo" : false,
      "gradient" : false,
      "gradientWidth" : 400
    },
    "samlConfiguration" : {
      "entityId" : null,
      "ssoEnabled" : false,
      "userJit" : true,
      "forceSso" : false,
      "adminsUsePassword" : true,
      "disableProfileEdit" : false
    },
    "hash" : null,
    "type" : "account"
  }
} ]
List item fields are defined in Get a single group data

4.3. Notifications

This section is incomplete and provides only request example.

4.3.1. List notifications

Example of a request
GET /v2/notifications HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com

4.3.2. Mark all notifications as read

Example of a request
PUT /v2/notifications HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com

4.3.3. Mark single notification as read

Example of a request
PUT /v2/notifications/1 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com

4.4. Applications

4.4.1. List user applications

Lists all user applications.

Example of a request
GET /v2/applications HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/applications' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1478

[ {
  "id" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "clientId" : "f28244aa-dcca-4a6e-bc95-00ad93be9bc4",
  "clientSecret" : "1a301374-6f5f-4544-be98-7208e833737a",
  "scope" : [ ],
  "name" : "My Awesome App!",
  "description" : "This is my awesome test app",
  "platform" : "OTHER",
  "deviceType" : "Phone",
  "deviceModel" : "Google Pixel XL",
  "deviceOs" : "ANDROID",
  "appVersion" : "1.0",
  "bundleId" : "com.clinked.awesome",
  "deviceToken" : "be735c44-3c6f-4151-958e-dfe69eb2950b",
  "lastActivity" : 1514764800000,
  "ip" : "127.0.0.1",
  "authorities" : [ {
    "authority" : "ROLE_CLIENT"
  } ],
  "registeredRedirectUri" : [ ]
} ]
List item fields are defined in Get single application

4.4.2. Get single application

Table 89. /v2/applications/{application}
Parameter Description

application

Application client id

Example of a request
GET /v2/applications/f3166044-23d6-4814-9add-0b1612d0d7fd HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/applications/f3166044-23d6-4814-9add-0b1612d0d7fd' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1474

{
  "id" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "clientId" : "f3166044-23d6-4814-9add-0b1612d0d7fd",
  "clientSecret" : "0cda8fc7-139e-4b22-b24b-ae3b9447f7b1",
  "scope" : [ ],
  "name" : "My Awesome App!",
  "description" : "This is my awesome test app",
  "platform" : "OTHER",
  "deviceType" : "Phone",
  "deviceModel" : "Google Pixel XL",
  "deviceOs" : "ANDROID",
  "appVersion" : "1.0",
  "bundleId" : "com.clinked.awesome",
  "deviceToken" : "827a4dad-bf0f-44fd-a836-eb848b781a55",
  "lastActivity" : 1514764800000,
  "ip" : "127.0.0.1",
  "authorities" : [ {
    "authority" : "ROLE_CLIENT"
  } ],
  "registeredRedirectUri" : [ ]
}
Table 90. Definition of the returned fields
Path Type Description

deviceType

String

Device type: [Phone, Tablet, Watch, Browser, Other]

appVersion

String

Version

name

String

Name

bundleId

String

Bundle/package name

description

String

Description

deviceModel

String

Device model name

deviceToken

String

Device Firebase Cloud Messaging token for notifications

owner

Object

Application owner user

clientId

String

Client id

clientSecret

String

Client secret

scope

Array

Permission scopes

platform

String

Device platform: [IOS, ANDROID, SYNC, LINUX, WINDOWS, OTHER]

deviceOs

String

Device operating system name

authorities

Array

Authorities/roles

4.4.3. Create an application

Table 91. Request fields
Path Type Description

deviceType

String

Device type: [Phone, Tablet, Watch, Browser, Other]

appVersion

String

Version

name

String

Name

bundleId

String

Bundle/package name

description

String

Description

deviceModel

String

Device model name

deviceToken

String

Device Firebase Cloud Messaging token for notifications

platform

String

Device platform: [IOS, ANDROID, SYNC, LINUX, WINDOWS, OTHER]

deviceOs

String

Device operating system name

Example of a request
POST /v2/applications HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 307

{
  "deviceType" : "Phone",
  "appVersion" : "1.0",
  "deviceOs" : "Android",
  "name" : "Awesome App",
  "bundleId" : "com.clinked.awesome",
  "description" : "This is my awesome app",
  "deviceModel" : "Google Pixel XL",
  "platform" : "ANDROID",
  "deviceToken" : "9b9fd357-715d-45c2-a92a-a38233a12101"
}
$ curl 'https://api-p1.clinked.com/v2/applications' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "deviceType" : "Phone",
  "appVersion" : "1.0",
  "deviceOs" : "Android",
  "name" : "Awesome App",
  "bundleId" : "com.clinked.awesome",
  "description" : "This is my awesome app",
  "deviceModel" : "Google Pixel XL",
  "platform" : "ANDROID",
  "deviceToken" : "9b9fd357-715d-45c2-a92a-a38233a12101"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1472

{
  "id" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "clientId" : "79df4f5fb1e6437a36456aeea5bb5242",
  "clientSecret" : "c637f44fd9c34753af2dbe1b7396c30d",
  "scope" : [ "read", "write", "smartsync" ],
  "name" : "Awesome App",
  "description" : "This is my awesome app",
  "platform" : "ANDROID",
  "deviceType" : "Phone",
  "deviceModel" : "Google Pixel XL",
  "deviceOs" : "Android",
  "appVersion" : "1.0",
  "bundleId" : "com.clinked.awesome",
  "deviceToken" : "9b9fd357-715d-45c2-a92a-a38233a12101",
  "lastActivity" : null,
  "ip" : null,
  "authorities" : [ {
    "authority" : "ROLE_CLIENT"
  } ],
  "registeredRedirectUri" : [ ]
}
List item fields are defined in Get single application

4.4.4. Update an application

Table 92. /v2/applications/{application}
Parameter Description

application

Application client id

Table 93. Request fields
Path Type Description

deviceType

String

Device type: [Phone, Tablet, Watch, Browser, Other]

appVersion

String

Version

name

String

Name

bundleId

String

Bundle/package name

description

String

Description

deviceModel

String

Device model name

deviceToken

String

Device Firebase Cloud Messaging token for notifications

platform

String

Device platform: [IOS, ANDROID, SYNC, LINUX, WINDOWS, OTHER]

deviceOs

String

Device operating system name

Example of a request
PUT /v2/applications/67ae2622-ebdb-4815-807a-0d3f1662cf03 HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 307

{
  "deviceType" : "Phone",
  "appVersion" : "1.0",
  "deviceOs" : "Android",
  "name" : "Awesome App",
  "bundleId" : "com.clinked.awesome",
  "description" : "This is my awesome app",
  "deviceModel" : "Google Pixel XL",
  "platform" : "ANDROID",
  "deviceToken" : "d528159f-c98a-46d1-8655-1c57f0995faf"
}
$ curl 'https://api-p1.clinked.com/v2/applications/67ae2622-ebdb-4815-807a-0d3f1662cf03' -i -X PUT -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "deviceType" : "Phone",
  "appVersion" : "1.0",
  "deviceOs" : "Android",
  "name" : "Awesome App",
  "bundleId" : "com.clinked.awesome",
  "description" : "This is my awesome app",
  "deviceModel" : "Google Pixel XL",
  "platform" : "ANDROID",
  "deviceToken" : "d528159f-c98a-46d1-8655-1c57f0995faf"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 1467

{
  "id" : null,
  "owner" : {
    "id" : 1,
    "comments" : 0,
    "attachments" : 0,
    "contextKey" : {
      "id" : null,
      "parent" : null,
      "objectType" : "com.rabbitsoft.clinked.domain.User",
      "objectId" : 1
    },
    "username" : "jack",
    "enabled" : true,
    "locked" : false,
    "twoFactorAuthentication" : false,
    "lastModified" : 1514764800000,
    "lastLogin" : 1514764800000,
    "dateCreated" : 1514764800000,
    "dateActivated" : 1514764800000,
    "name" : "Jack Bauer",
    "jobTitle" : "Marketing",
    "organisation" : "Clinked",
    "email" : "jack.bauer@clinked.com",
    "address" : "71 Pilgrim Avenue",
    "telephone" : "123456789",
    "other" : null,
    "logo" : false,
    "timeZone" : "Etc/UTC",
    "locale" : "en",
    "verifiedEmail" : false,
    "twoFactorMode" : null,
    "timeZoneOffset" : 0,
    "type" : "user"
  },
  "clientId" : "67ae2622-ebdb-4815-807a-0d3f1662cf03",
  "clientSecret" : "51b18dbd-30df-44bb-a8f5-8a02706c1417",
  "scope" : [ ],
  "name" : "Awesome App",
  "description" : "This is my awesome app",
  "platform" : "ANDROID",
  "deviceType" : "Phone",
  "deviceModel" : "Google Pixel XL",
  "deviceOs" : "Android",
  "appVersion" : "1.0",
  "bundleId" : "com.clinked.awesome",
  "deviceToken" : "d528159f-c98a-46d1-8655-1c57f0995faf",
  "lastActivity" : 1514764800000,
  "ip" : "127.0.0.1",
  "authorities" : [ {
    "authority" : "ROLE_CLIENT"
  } ],
  "registeredRedirectUri" : [ ]
}
List item fields are defined in Get single application

4.4.5. Delete an application

Deletes and revokes application access.

Table 94. /v2/applications/{application}
Parameter Description

application

Application client id

Example of a request
DELETE /v2/applications/d09eeb3d-a7fa-401b-b866-baabb8991c53 HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/applications/d09eeb3d-a7fa-401b-b866-baabb8991c53' -i -X DELETE -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK

4.5. User properties

Each user has its own map (key → value) of properties that can be used to change personal preferences.

4.5.1. List properties

Lists all user properties.

Example of a request
GET /v2/users/properties HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/users/properties' -i -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 122

[ {
  "name" : "user.property.name1",
  "value" : "value1"
}, {
  "name" : "user.property.name2",
  "value" : "value2"
} ]
Table 95. Definition of the returned fields
Path Type Description

[].name

String

Property name

[].value

String

Property value

4.5.2. Create a property

Creates a user property.

Example of a request
POST /v2/users/properties HTTP/1.1
Content-Type: application/json
Accept: application/json
Host: api-p1.clinked.com
Content-Length: 56

{
  "name" : "user.property.name",
  "value" : "value"
}
$ curl 'https://api-p1.clinked.com/v2/users/properties' -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{
  "name" : "user.property.name",
  "value" : "value"
}'
Example of a success response
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Content-Length: 91

{
  "id" : null,
  "context" : null,
  "name" : "user.property.name",
  "value" : "value"
}
Table 96. Definition of the returned fields
Path Type Description

name

String

Property name

value

String

Property value

4.5.3. Delete a property

Deletes a user property.

Table 97. /v2/users/properties/{property}
Parameter Description

property

Property name

Example of a request
DELETE /v2/users/properties/user.property.name HTTP/1.1
Accept: application/json
Host: api-p1.clinked.com
$ curl 'https://api-p1.clinked.com/v2/users/properties/user.property.name' -i -X DELETE -H 'Accept: application/json'
Example of a success response
HTTP/1.1 200 OK

5. Appendix A: Forbidden file names

  • new

  • delete

  • download

  • clipboard

6. Appendix B: Forbidden user names

  • invite

  • list

  • tags

  • anonymous

  • signup

  • site

  • ping

  • static

  • customise

  • users

  • uses

  • password

  • settings

  • search

  • packages

  • clientcountry

  • shares

  • login

  • verify_code

  • .

  • favicon.ico

  • robots.txt

  • new_space

  • new_space_duplicate

  • uncaught_exception

  • access_denied

  • not_found

  • userdata

  • following

  • _jserr

  • api

  • google

  • linkedin

  • image

  • messages

  • mentions

  • token_password

  • requests

  • activity

  • activity_share

  • tracking

  • events

  • tasks

  • spaces

  • people

  • pages

  • discussions

  • files

  • generalinfo

  • tinymce

  • getting_started

  • conversation

  • notifications

  • members

7. Appendix C: Forbidden group names

  • signup

  • site

  • ping

  • static

  • customise

  • users

  • uses

  • password

  • settings

  • search

  • packages

  • clientcountry

  • shares

  • login

  • verify_code

  • .

  • favicon.ico

  • robots.txt

  • new_space

  • new_space_duplicate

  • uncaught_exception

  • access_denied

  • not_found

  • userdata

  • following

  • _jserr

  • api

  • google

  • linkedin

  • image

  • messages

  • mentions

  • token_password

  • requests

  • activity

  • activity_share

  • tracking

  • events

  • tasks

  • spaces

  • people

  • pages

  • discussions

  • files

  • generalinfo

  • tinymce

  • getting_started

  • conversation

  • notifications

  • members

8. Appendix D: Update templates

update.organisation.create={0} created account {1}
update.organisation.disable={0} disabled account {1}
update.organisation.enabled={0} enabled account {1}

update.user.private={0} said
update.user.profile={0} said to {4}
update.organisation.private={0} in {1} said
update.organisation.join={0} joined {1}
update.space.private={0} in {2} said
update.following.start={0} started following {3} in {2}
update.following.stop={0} stopped following {3} in {2}
update.discussion.create={0} created new [discussions:0:0] {3} in {2}
update.discussion.update={0} updated [discussions:0:0] {3} in {2}
update.discussion.createreply={0} replied to [discussions:0:0] {3} in {2}
update.space.create={0} created a new group {2}
update.space.join={0} joined {2} group
update.trash.remove={0} deleted group {2}
update.trash.restore={0} restored group {2}
update.trash.delete={0} deleted group {2} from {1} trash
update.filestore.create={0} uploaded [files:0:0] {3} in {2}
update.filestore.update={0} updated [files:0:0] {3} in {2}
update.filestore.folder={0} created folder {3} in {2}
update.filestore.rename={0} renamed "{5}" to {3} in {2}
update.filestore.move={0} moved {3} to "{5}" in {2}
update.filestore.copy={0} copied {3} to "{5}" in {2}
update.filestore.approval.accept={0} approved [files:0:0] {3} in {2}
update.filestore.approval.reject={0} rejected [files:0:0] {3} in {2}
update.event.create={0} created [events:0:0] {3} in {2}
update.event.createandassign={0} created [events:0:0] {3} in {2}
update.event.update={0} updated [events:0:0] {3} in {2}
update.event.updateandassign={0} updated [events:0:0] {3} in {2}
update.task.create={0} created [tasks:0:0] {3} in {2}
update.task.createandassign={0} created [tasks:0:0] {3} in {2}
update.task.update={0} updated [tasks:0:0] {3} in {2}
update.task.updateandassign={0} updated [tasks:0:0] {3} in {2}
update.task.complete={0} completed [tasks:0:0] {3} in {2}
update.task.reopen={0} marked [tasks:0:0] {3} as incomplete in {2}

update.attachment.create={0} attached file {5} to {3} in {2}
update.attachment.update={0} updated attachment {5} in {3}

update.page.create={0} created new [pages:0:0] {3} in {2}
update.page.update={0} updated [pages:0:0] {3} in {2}
update.page.restore={0} restored [pages:0:0] {3} version {5} in {2}
update.page.renameandupdate={0} moved [pages:0:0] {5} to {3} in {2}

update.news.create={0} created new [news:0:0] {3} in {2}
update.news.update={0} updated [news:0:0] {3} in {2}
update.news.restore={0} restored [news:0:0] {3} version {5} in {2}
update.news.renameandupdate={0} moved [news:0:0] {5} to {3} in {2}

update.comment.create={0} commented on {3} in {2}
update.comment.update={0} updated comment on {3} in {2}

update.comment.delete={0} deleted comment from {3} in {2}

update.comment.reply={0} replied on {3} in {2}
update.annotate.create={0} annotated {3} in {2}
update.annotate.delete={0} deleted annotation from {3} in {2}

update.space.trash.filerecord.create={0} deleted {3} in {2}
update.space.trash.filerecord.attemptRestore={0} restored {3} in {2}
update.space.trash.filerecord.delete={0} permanently deleted {3} from {2} trash
update.space.trash.page.create={0} deleted [pages:0:0] {3} in {2}
update.space.trash.page.attemptRestore={0} restored [pages:0:0] {3} in {2}
update.space.trash.page.delete={0} permanently deleted [pages:0:0] {3} from {2} trash
update.space.trash.news.create={0} deleted [news:0:0] {3} in {2}
update.space.trash.news.attemptRestore={0} restored [news:0:0] {3} in {2}
update.space.trash.news.delete={0} permanently deleted [news:0:0] {3} from {2} trash

update.space.trash.discussion.create={0} deleted [discussions:0:0] {3} in {2}
update.space.trash.discussion.attemptRestore={0} restored [discussions:0:0] {3} in {2}
update.space.trash.discussion.delete={0} permanently deleted [discussions:0:0] {3} from {2} trash
update.space.trash.event.create={0} deleted [events:0:0] {3} in {2}
update.space.trash.event.attemptRestore={0} restored [events:0:0] {3} in {2}
update.space.trash.event.delete={0} permanently deleted [events:0:0] {3} from {2} trash
update.space.trash.task.create={0} deleted [tasks:0:0] {3} in {2}
update.space.trash.task.attemptRestore={0} restored [tasks:0:0] {3} in {2}
update.space.trash.task.delete={0} permanently deleted [tasks:0:0] {3} from {2} trash
update.space.rename={0} renamed group {5} to {2}
update.space.move={0} moved group {2} from {3}
update.space.remove={0} removed group {2}
update.space.restore={0} restored group {2} from trash

update.attachment.create.notify={0} attached the file {2} to {1}
update.attachment.update.notify={0} updated the attachment {2} to {1}
update.discussion.createreply.notify={0} replied to [discussions:0:0] {1}
update.event.update.notify={0} edited the [events:0:0] {1}
update.event.updateandassign.notify={0} edited the [events:0:0] {1}
update.filestore.update.notify={0} edited the [files:0:0] {1}
update.filestore.folder.notify={0} created folder {1}
update.filestore.create.notify={0} created a new [files:0:0] {1}
update.page.update.notify={0} changed the [pages:0:0] {1}
update.page.renameandupdate.notify={0} changed the [pages:0:0] {1}
update.space.trash.discussion.create.notify={0} deleted the [discussions:0:0] {1}
update.space.trash.event.create.notify={0} deleted the [events:0:0] {1}
update.space.trash.filerecord.create.notify={0} deleted the [files:0:0] {1}
update.space.trash.news.create.notify={0} deleted the [news:0:0] {1}
update.space.trash.page.create.notify={0} deleted the [pages:0:0] {1}
update.space.trash.task.create.notify={0} deleted the [tasks:0:0] {1}
update.space.trash.discussion.attemptRestore.notify={0} restored the [discussions:0:0] {1}
update.space.trash.event.attemptRestore.notify={0} restored the [events:0:0] {1}
update.space.trash.filerecord.attemptRestore.notify={0} restored the [files:0:0] {1}
update.space.trash.page.attemptRestore.notify={0} restored the [pages:0:0] {1}
update.space.trash.news.attemptRestore.notify={0} restored the [news:0:0] {1}
update.space.trash.task.attemptRestore.notify={0} restored the [tasks:0:0] {1}
update.task.complete.notify={0} completed the [tasks:0:0] {1}
update.task.reopen.notify={0} marked the [tasks:0:0] {1} as uncompleted
update.task.update.notify={0} changed the [tasks:0:0] {1}
update.task.updateandassign.notify={0} changed the [tasks:0:0] {1}
update.comment.create.notify={0} commented on {1}
update.comment.reply.notify={0} commented on {1}