Get organization teams

Role

Administrator or Member

Method

GET

URL

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

Scope

organization.read

URL parameters

Name Type Description
spaceKey String Organization key

Query parameters

Name Type Description
offset (Optional) Number default value: 0
count (Optional) Number default value: 20, maximum: 100

Response Example

The properties teams and team are the same as groups and group defined in other Nulab APIs. We are planning to update them to teams and team in the future.

{
    "space": {
        "key": "pCq9wxceDX",
        "name": "Awesome Tech Inc.",
        "enabled": true,
        "imageUrl": "https://apps.nulab.com/spaces/pCq9wxceDX/photo/large"
    },
    "teams": [
        {
            "team": {
                "key": "db0jsi",
                "name": "Awesome Tech Inc. All",
                "suggestion": "Awesome Tech Inc. All",
                "imageUrl": "https://apps.nulab.com/spaces/pCq9wxceDX/groups/db0jsi/photo/medium",
                "createdAt": "2016-01-27T09:37:26Z",
                "updatedAt": "2020-07-06T06:37:30Z"
            },
            "members": [
                {
                    "id": 2500,
                    "name": "Jessica",
                    "fullName": "Jessica Lee",
                    "suggestion": "Jessica Lee",
                    "imageUrl": "https://typetalk.com/accounts/2500/profile_image.png?t=1575882224150",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:35Z",
                    "updatedAt": "2021-02-02T07:01:47Z",
                    "imageUpdatedAt": "2019-12-09T09:03:44Z",
                    "mailAddress": "jessica@nulab.com",
                    "lang": "en-US",
                    "timezoneId": "America/New_York",
                    "nulabId": "h3gItzV8KZdgychvTuJ9KIs3w6AGaG7dbXhHjeL8kPOG04pvmT"
                },
                {
                    "id": 2499,
                    "name": "Moss",
                    "fullName": "Moss",
                    "suggestion": "Moss",
                    "imageUrl": "https://typetalk.com/accounts/2499/profile_image.png?t=1453891379196",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:23Z",
                    "updatedAt": "2021-01-08T03:54:15Z",
                    "imageUpdatedAt": "2016-01-27T10:42:59Z",
                    "mailAddress": "moss@nulab.com",
                    "lang": "en-US",
                    "timezoneId": "America/New_York",
                    "nulabId": "GOy7cz34mHxFoi686a37BiU0vfwcgKgkBLpL6ZHhOk3pi6sjDc"
                },
                {
                    "id": 2498,
                    "name": "Stefanie",
                    "fullName": "Stefanie",
                    "suggestion": "Stefanie",
                    "imageUrl": "https://typetalk.com/accounts/2498/profile_image.png?t=1453891479138",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:55:09Z",
                    "updatedAt": "2020-09-02T08:46:01Z",
                    "imageUpdatedAt": "2016-01-27T10:44:39Z",
                    "mailAddress": "stefanie@nulab.com",
                    "lang": "en-US",
                    "timezoneId": "America/New_York",
                    "nulabId": "kdn4zwBv2mui730vFicktDDWXB5huSo7cncpJnPCANfhj32QNO"
                },
                {
                    "id": 2497,
                    "name": "Will",
                    "fullName": "Will",
                    "suggestion": "Will",
                    "imageUrl": "https://typetalk.com/accounts/2497/profile_image.png?t=1510596200433",
                    "isBot": false,
                    "createdAt": "2016-01-27T09:54:48Z",
                    "updatedAt": "2021-02-02T05:48:36Z",
                    "imageUpdatedAt": "2017-11-13T18:03:20Z",
                    "mailAddress": "will@nulab.com",
                    "lang": "en-US",
                    "timezoneId": "America/New_York",
                    "nulabId": "CVy8qneGRJ32poiYWXnOszykGPUQNAh05ngWDOhZzvC4KWmGKx"
                }
            ]
        }
    ]
}

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).