Get teams

Get all teams in an organization.

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