Contents

Get my organizations

Get organizations you have joined.

Method

GET

URL

https://typetalk.com/api/v1/spaces

Scope

my

Query parameters

NameTypeDescription
excludesGuest (Optional)BooleanIf this is true, response excludes organizations that your role is guest in.

Response Example

{
  "mySpaces": [
    {
      "space": {
        "key": "abcdefghij",
        "name": "Joe Tech Inc.",
        "enabled": true,
        "imageUrl": "https://apps.nulab.com/spaces/abcdefghij/photo/large"
      },
      "myRole": "ADMIN",
      "isPaymentAdmin": true,
      "myPlan": {
        "plan": {
          "key": "typetalk.free",
          "name": "Free Plan",
          "limitNumberOfUsers": 10,
          "limitTotalAttachmentSize": 1073741824
        },
        "enabled": true,
        "trial": null,
        "numberOfUsers": 6,
        "totalAttachmentSize": 0,
        "createdAt": "2016-01-10T02:32:29Z",
        "updatedAt": "2016-12-21T10:12:18Z"
      }
    },
    {
      "space": {
        "key": "0123456789",
        "name": "Nu team",
        "enabled": true,
        "imageUrl": "https://apps.nulab.com/spaces/0123456789/photo/large"
      },
      "myRole": "USER",
      "isPaymentAdmin": false,
      "myPlan": {
        "plan": {
          "key": "typetalk.starter",
          "name": "Starter Plan",
          "limitNumberOfUsers": 10,
          "limitTotalAttachmentSize": 10737418240
        },
        "enabled": true,
        "trial": {
          "endDate": "2017-01-04",
          "daysLeft": 15
        },
        "numberOfUsers": 2,
        "totalAttachmentSize": 0,
        "createdAt": "2016-12-06T01:11:43Z",
        "updatedAt": "2016-12-21T01:11:43Z"
      }
    }
  ]
}

All responses are formatted in JSON and include an ETag. If you call an API with an If-None-Match header, the server will return a 304 status code if the data is unchanged. The date and time format is ISO 8601, and the timezone is UTC (eg. 2014-01-09T06:20:08Z).