@@ -148,99 +148,6 @@ curl -X GET http://coder-server:8080/api/v2/entitlements \
148
148
149
149
To perform this operation, you must be authenticated. [ Learn more] ( authentication.md ) .
150
150
151
- ## Get groups
152
-
153
- ### Code samples
154
-
155
- ``` shell
156
- # Example request using curl
157
- curl -X GET http://coder-server:8080/api/v2/groups \
158
- -H ' Accept: application/json' \
159
- -H ' Coder-Session-Token: API_KEY'
160
- ```
161
-
162
- ` GET /groups `
163
-
164
- ### Parameters
165
-
166
- | Name | In | Type | Required | Description |
167
- | -------------- | ---- | ------------ | -------- | --------------- |
168
- | ` organization ` | path | string(uuid) | true | Organization ID |
169
-
170
- ### Example responses
171
-
172
- > 200 Response
173
-
174
- ``` json
175
- [
176
- {
177
- "avatar_url" : " string" ,
178
- "id" : " 497f6eca-6276-4993-bfeb-53cbbbba6f08" ,
179
- "members" : [
180
- {
181
- "avatar_url" : " http://example.com" ,
182
- "created_at" : " 2019-08-24T14:15:22Z" ,
183
- "email" : " user@example.com" ,
184
- "id" : " 497f6eca-6276-4993-bfeb-53cbbbba6f08" ,
185
- "last_seen_at" : " 2019-08-24T14:15:22Z" ,
186
- "organization_ids" : [" 497f6eca-6276-4993-bfeb-53cbbbba6f08" ],
187
- "roles" : [
188
- {
189
- "display_name" : " string" ,
190
- "name" : " string"
191
- }
192
- ],
193
- "status" : " active" ,
194
- "username" : " string"
195
- }
196
- ],
197
- "name" : " string" ,
198
- "organization_id" : " 7c60d51f-b44e-4682-87d6-449835ea4de6" ,
199
- "quota_allowance" : 0
200
- }
201
- ]
202
- ```
203
-
204
- ### Responses
205
-
206
- | Status | Meaning | Description | Schema |
207
- | ------ | ------------------------------------------------------- | ----------- | --------------------------------------------------- |
208
- | 200 | [ OK] ( https://tools.ietf.org/html/rfc7231#section-6.3.1 ) | OK | array of [ codersdk.Group] ( schemas.md#codersdkgroup ) |
209
-
210
- <h3 id =" get-groups-responseschema " >Response Schema</h3 >
211
-
212
- Status Code ** 200**
213
-
214
- | Name | Type | Required | Restrictions | Description |
215
- | --------------------- | ---------------------------------------------------- | -------- | ------------ | ----------- |
216
- | ` [array item] ` | array | false | | |
217
- | ` » avatar_url ` | string | false | | |
218
- | ` » id ` | string(uuid) | false | | |
219
- | ` » members ` | array | false | | |
220
- | ` »» avatar_url ` | string(uri) | false | | |
221
- | ` »» created_at ` | string(date-time) | true | | |
222
- | ` »» email ` | string(email) | true | | |
223
- | ` »» id ` | string(uuid) | true | | |
224
- | ` »» last_seen_at ` | string(date-time) | false | | |
225
- | ` »» organization_ids ` | array | false | | |
226
- | ` »» roles ` | array | false | | |
227
- | ` »»» display_name ` | string | false | | |
228
- | ` »»» name ` | string | false | | |
229
- | ` »» status ` | [ codersdk.UserStatus] ( schemas.md#codersdkuserstatus ) | false | | |
230
- | ` »» username ` | string | true | | |
231
- | ` » name ` | string | false | | |
232
- | ` » organization_id ` | string(uuid) | false | | |
233
- | ` » quota_allowance ` | integer | false | | |
234
-
235
- #### Enumerated Values
236
-
237
- | Property | Value |
238
- | -------- | ----------- |
239
- | ` status ` | ` active ` |
240
- | ` status ` | ` suspended ` |
241
-
242
- To perform this operation, you must be authenticated. [ Learn more] ( authentication.md ) .
243
-
244
151
## Get group by name
245
152
246
153
### Code samples
0 commit comments