Get Space

Gets information of a Space.

MethodGET
URLhttps://{subdomain}.kintone.com/k/v1/space.json
URL(guest space)https://{subdomain}.kintone.com/k/guest/{SpaceID}/v1/space.json
Authentication Password Authentication , Session Authentication
Content-Typeapplication/json (not needed if specifying the query with a query string)

Contents

Permissions

For private spaces, the user must be a member of the Space.

Request Parameters

Parameter Value Required Description
id Integer or String Yes The Space ID.
The Space ID can be found in the URL of the Space.
A Space with the URL of https://{domainname}.kintone.com/k/#/space/111 has a Space ID of 111.

Sample Request

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
var body = {
  'id': 1
};

kintone.api(kintone.api.url('/k/v1/space.json', true), 'GET', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

XMLHttpRequest

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
var url = 'https://{subdomain}.kintone.com/k/v1/space.json?id=1';

var xhr = new XMLHttpRequest();
xhr.open('GET', url);
xhr.setRequestHeader('X-Requested-With', 'XMLHttpRequest');
xhr.onload = function() {
  if (xhr.status === 200) {
    // success
    console.log(JSON.parse(xhr.responseText));
  } else {
    // error
    console.log(JSON.parse(xhr.responseText));
  }
};
xhr.send();

Response Parameters

Parameter Type Description
id String The Space ID.
name String The name of the Space
defaultThread String The Thread ID of the default thread that was created when the Space was made.
isPrivate Boolean The "Private" settings of the Space.
true: The Space is private.
false: The Space is not private.
creator Object An object containing information of the creator of the Space.
creator.code String The code (log in name) of the creator.
An empty string is returned for inactive or deleted users.
creator.name String The display name of the creator.
An empty string is returned for inactive or deleted users.
modifier Object An object containing information of the updater of the Space.
modifier.code String The code (log in name) of the updater.
An empty string is returned for inactive or deleted users.
modifier.name String The display name of the updater.
An empty string is returned for inactive or deleted users.
memberCount String The number of members of the Space.
coverType String The image type of the Cover Photo.
BLOB: An uploaded image.
PRESET: A preset image.
coverKey String The key of the Cover Photo.
coverUrl String The URL of the Cover Photo.
body String The HTML of the Space body.
Null is returned if the HTML in the body is empty.
However, if the body has been set before, the HTML tags may be set even if nothing is displayed on the screen and the string will be returned.
useMultiThread Boolean The Enable multiple threads setting.
true: The Space is a Multi-threaded Space.
false: The Space is a Single-threaded Space.
isGuest Boolean The Guest Space setting.
true: The Space is a Guest Space.
false: The Space is not a Guest Space.
attachedApps Array A list of Apps that are in the thread.
This does not include Apps that are not live yet.
attachedApps[].threadId String The Thread ID of the thread that the App was created in.
Apps that are created inside Spaces using the GUI will be automatically allocated to the default Thread.
attachedApps[].appId String The App ID.
attachedApps[].code String The App Code of the App.
An empty string is returned if an App Code is not set in the App's settings.
attachedApps[].name String The name of the App.
If the App has localization settings, the localized name will be returned.
attachedApps[].description String The description of the App.
If the App has localization settings, the localized description will be returned.
attachedApps[].createdAt String The date of when the App was created.
attachedApps[].creator Object The information of the user who created the App.
attachedApps[].creator.code String The code (log in name) of the creator.
An empty string is returned for inactive users and deleted users.
attachedApps[].creator.name String The display name of the creator.
An empty string is returned for inactive users and deleted users.
attachedApps[].modifiedAt String The date of when the App was last updated.
attachedApps[].modifier Object The information of the user who last updated the App.
attachedApps[].modifier.code String The code (log in name) of the last updater.
An empty string is returned for inactive users and deleted users.
attachedApps[].modifier.name String The display name of the last updater.
An empty string is returned for inactive users and deleted users.
fixedMember Boolean The options set for the Block users from joining or leaving the space and following or unfollowing the threads setting.
true: Users cannot join/leave the Space or follow/unfollow threads.
false: Users can join/leave the Space and follow/unfollow threads.
showAnnouncement Boolean The display status for the Announcement widget.
true: The Announcement widget is displayed.
false: The Announcement widget is not displayed.
null is returned for Spaces with the Enable multiple threads option turned off.
showThreadList Boolean The display status for the Threads widget.
true: The Threads widget is displayed.
false: The Threads widget is not displayed.
null is returned for Spaces with the Enable multiple threads option turned off.
showAppList Boolean The display status for the Apps widget.
true: The Apps widget is displayed.
false: The Apps widget is not displayed.
null is returned for Spaces with the Enable multiple threads option turned off.
showMemberList Boolean The display status for the People widget.
true: The People widget is displayed.
false: The People widget is not displayed.
null is returned for Spaces with the Enable multiple threads option turned off.
showRelatedLinkList Boolean The display status for the Related Apps & Spaces widget.
true: The Related Apps & Spaces widget is displayed.
false: The Related Apps & Spaces widget is not displayed.
null is returned for Spaces with the Enable multiple threads option turned off.
permissions Object An object containing information of the space's permission settings.
permissions.createApp String The option set for the Only Allow Space Administrators to Create Apps setting
EVERYONE: all users can create Apps.
ADMIN: only administrators can create Apps.

Sample Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
{
  "id": "1",
  "name": "Sample Space Name",
  "defaultThread": "12",
  "isPrivate": false,
  "creator": {
    "code": "john-d",
    "name": "John Doe"
  },
  "modifier": {
    "code": "john-d",
    "name": "John Doe"
  },
  "memberCount": 3,
  "coverType": "PRESET",
  "coverKey": "GREEN",
  "coverUrl": "https://*******/green.jpg",
  "body": "<b>Space Body</b>",
  "useMultiThread": false,
  "showAnnouncement": true,
  "showThreadList": true,
  "showAppList": true,
  "showMemberList": true,
  "showRelatedLinkList": true,
  "isGuest": false,
  "fixedMember": false,
  "permissions": {
    "createApp": "EVERYONE"
  },
  "attachedApps": [
    {
      "appId": "33",
      "code": "",
      "name": "Document Library",
      "description": "Document Library Description",
      "createdAt": "2017-03-08T06:31:30.000Z",
      "creator": {
        "code": "john-d",
        "name": "John Doe"
      },
      "modifiedAt": "2017-03-13T01:36:17.000Z",
      "modifier": {
        "code": "jane-r",
        "name": "Jane Roe"
      },
      "threadId": "12"
    },
    {
      "appId": "52",
      "code": "",
      "name": "Recruiting Pack",
      "description": "Recruiting Pack Description",
      "createdAt": "2017-03-30T06:30:26.000Z",
      "creator": {
        "code": "john-d",
        "name": "John Doe"
      },
      "modifiedAt": "2017-04-10T09:09:51.000Z",
      "modifier": {
        "code": "john-d",
        "name": "John Doe"
      },
      "threadId": "12"
    }
  ]
}

Limitations

  • If the Space or Guest Space feature is turned off, an error will be returned.