Create a new space.

URL Parameters

None.

Body Parameters

NameDescriptionJSON typeRequiredDefault Value
cidUser ID of the Space's creatorStringRequired
titleName of the space to be createdStringRequired
descriptionA description of the SpaceStringNo
membersMember data for members of the SpaceArray of member objectsYes

Authentication

JwtAuthenticator, Oauth2Authenticator, AnonymousAuthenticator

Authorization

PERM_TOPIC_CREATE

Example Request

URL

POST https://spacesapis.zang.io/api/spaces/

Headers

Authorization: "jwt eyJhbGciOiJSUzI1NiIsIdfgdfgnR5cCI6IkpXVCJ9.eyJ1c2VyX2lkX3NpZyI6ImxPWHpxNzVzR3J3X0xwWEMyRGRMakhyYXJlWVhyTzFMdEZHZkhkOWNkTXciLCJwcm9kdWN0X3R5cGUiOiJhY2NvdW50cyIsImxhc3R1cGRhdGV0aW1lIjoiMjAxNy0wMS0zMFQxMzo1ODo0Ny4yMDYiLCJpc3MiOiJ6YW5nLmlvIiwicHVibGlja2V5aWQiOiJhZ3h6Zm05dVpYTnVZVEl3TVRSeUdnc1NEVWRLZDNSUWRXSnNhV05MWlhrdfgdWdJQ2dsUEtFakFvTSIsImV4cCI6MTQ5NTM5MTIwMywidXNlcl9pZCI6ImFneHpmbTl1WlhOdVlUSXdNVFJ5RVFzU0JGVnpaWElZZ0lEQXMtX25fUW9NIiwidmVyIjoiMi4wIn0.SqZpw1uPIebqW3qlDsm0-DWYFKEH0SgPwtD-tSESWOF-5hLkZMqJH28ooWux2S7s9riIew7pTVPnZpTgJa5zHcEAG0gXSEJVOqmpGp_4ufM8YtZoZMpBFjyAkwyAt-ILkGUYIo0GU5WyzMPLV8YLXfgdfgOgkE2MGGOajBkjPmC2Db3pA0D0M9k-21EL1gwWBC5YIq0PDAkgulegwl6khRmB8irJQ-dfg-d-KV9eYfFpsCdJKRGzSfqg"

Or

Authorization: "bearer f746696f5de4528u128ae2f274eea253e8a7943a"

Body

{
  "cid": "5890b1243bab0e18ff044943",
  "title": "space title2",
  "description": "space desc2",
  "members": [
    {
      "member": "5890b1243bab0e18ff044943",
      "memberType": "userId",
      "role": "admin",
      "joinTime": "2017-03-14T20:13:56.727Z",
      "username": "patrickhan@esna.com",
      "displayname": "Patrick-123 Han-han",
      "picture_url": "https://www.onesna.com/norevimages/noimage.jpg"      
    }
  ]
}

Example Response

{
  "cid": "5890b1243bab0e18ff044943",
  "title": "space title2",
  "description": "space desc2",
  "_id": "590265a0c284716066e5ea3f",
  "restrict": [],
  "status": 0,
  "members": [
    {
      "member": "5890b1243bab0e18ff044943",
      "memberType": "userId",
      "role": "admin",
      "joinTime": "2017-03-14T20:13:56.727Z",
      "username": "patrickhan@esna.com",
      "displayname": "Patrick-123 Han-han",
      "picture_url": "https://www.onesna.com/norevimages/noimage.jpg"      
    }
  ],
  "parents": [],
  "settings": {
    "mdOpts": [],
    "mdSrv": "ams"
  },
  "created": "2017-04-27T21:41:52.797Z",
  "type": "group"
}