Add Space

Last Updated:
Follow
Creates a Space from a Space template

Method POST
URL https://{subdomain}.kintone.com/k/v1/template/space.json
Authentication Password Authentication
Content-Type application/json

Permissions

  • For creating Guest Spaces, the user will need to have permission to create Guest Spaces.

Request Parameters

Parameter Value Required Description
id Integer or String Yes The Space Template ID.
Check here for instructions on creating Space Templates.
The Space Template ID is listed on the Space Templates list page, found under https://{domainname}.kintone.com/k/admin/system/spacetemplate/
name String Yes The new name of the Space.
members Array Yes

A list of members of the Space.
At least one Space Administrator must be specified.
Inactive and deleted users cannot be specified.
members[].entity Object Yes The entity information of the Space member.
Guest users cannot be specified.
members[].entity.type String Yes The entity type of the Space member.
  • USER: User
  • Group: Group
  • ORGANIZATION: Department
members[].entity.code String Yes The code of the entity.
members[].isAdmin Boolean or String  Conditional

The Space Administration settings of the user.

  • true: The member will be the Administrator of the Space.
  • false: The member will not be the Administrator of the Space.

At least 1 Space Administrator is required to be set in the API call.
If ignored, this value is false.
members[].includeSubs Boolean or String   The "Include Affiliated Departments" settings of the department.
  • true: Affiliated departments will be included.
  • false: Affiliated departments will not be included.
If ignored, this value is false.
isPrivate Boolean or String   The "Private" settings of the Space.
  • true: The Space will be Private.
  • false: The Space will not be Private.
If the isGuest parameter is set to true, this value is also true.
If ignored, this value is false.
isGuest Boolean or String   The Guest Space settings of the Space.
  • true: The Space will be a Guest Space
  • false: The Space will be a normal Space.
If ignored, this value is false.
fixedMember Boolean or String  
The "Block users from joining or leaving the space and following or unfollowing the threads." settings of the Space.
  • true: Users will not be able to join/leave the Space or follow/unfollow threads.
  • false: Users will be able to join/leave the Space and follow/unfollow threads.
If ignored, this value is false.

Sample Request

JavaScript (using kintone REST API Request)

XMLHttpRequest

Response Parameters

Parameter Type Description
id String The Space ID of the created Space.

Sample Response

Limitations

  • If the Space or Guest Space feature is turned off, an error will be returned.
Was this article helpful?
0 out of 0 found this helpful
Do you have any questions or issues related to this article?
Please share your views with us in the Community forums!