Contents
組織のチーム一覧を取得する
組織が持つチーム一覧を取得します。
権限
管理者または一般ユーザー
メソッド
GET
URL
https://typetalk.com/api/v1/spaces/:spaceKey/teams
スコープ
organization.read
URL パラメーター
Name | Type | Description |
---|---|---|
spaceKey | String | 組織キー |
クエリパラメーター
名前 | 型 | 説明 |
---|---|---|
offset (任意) | 数値 | デフォルト値: 0 |
count (任意) | 数値 | デフォルト値: 20、最大値: 100 |
レスポンス例
teams
、team
プロパティーは他の API で定義している groups
、group
と同じです。 将来的にすべてを teams
、team
に移行する予定です。
{
"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 )