Contents

組織のチーム一覧を取得する

組織が持つチーム一覧を取得します。

権限

管理者または一般ユーザー

メソッド

GET

URL

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

スコープ

organization.read

URL パラメーター

NameTypeDescription
spaceKeyString組織キー

クエリパラメーター

名前説明
offset (任意)数値デフォルト値: 0
count (任意)数値デフォルト値: 20、最大値: 100

レスポンス例

teamsteam プロパティーは他の API で定義している groupsgroup と同じです。 将来的にすべてを teamsteam に移行する予定です。

{
    "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"
                }
            ]
        }
    ]
}

レスポンスのフォーマットは全て JSON です。GET メソッドは ETag に対応しているので、If-None-Match ヘッダを付けて送ると、変更がない場合は 304 を返します。日付のフォーマットは ISO 8601 で、UTC です。 (例 : 2014-01-09T06:20:08Z )