You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: website/docs/cloud-docs/api-docs/team-tokens.mdx
+9-5
Original file line number
Diff line number
Diff line change
@@ -38,7 +38,7 @@ description: >-
38
38
39
39
# Team tokens API reference
40
40
41
-
Team API tokens grant access to a team's workspaces. Teams are not limited to a single token, and can have multiple, valid tokens at a time. Team tokens are not are not associated with a specific user.
41
+
Team API tokens grant access to a team's workspaces. Teams are not limited to a single token, and can have multiple tokens at a time. Team tokens are not are not associated with a specific user.
42
42
43
43
Teams relying on the [**legacy**](/terraform/cloud-docs/api-docs/team-tokens#legacy-team-tokens-api-reference) team token API (`/teams/authentication-token`), can only have a **single**, valid token at a time. Generating a new legacy token revokes any previously existing tokens, replacing it with the new team token.
44
44
@@ -52,7 +52,7 @@ Generates a new team token.
52
52
| :----- | :----------------------------------- |
53
53
| POST | /teams/:team_id/authentication-tokens |
54
54
55
-
This endpoint returns the secret text of the new authentication token. You can only access this token when you create it and can not recover it later.
55
+
This endpoint returns the secret text of the new authentication token. You can only access the secret when you create it and cannot recover it later.
56
56
57
57
### Parameters
58
58
@@ -127,7 +127,7 @@ curl \
127
127
128
128
```
129
129
130
-
## Delete the team token
130
+
## Delete a team token
131
131
132
132
| Method | Path |
133
133
| :----- | :----------------------------------- |
@@ -296,15 +296,19 @@ curl \
296
296
297
297
# Legacy team tokens API reference
298
298
299
+
Legacy team API tokens grant access to a team's workspaces. Each team can have an API token that is not associated with a specific user.
300
+
You can create and delete team tokens and list an organization's team tokens.
301
+
The [team tokens API](/terraform/cloud-docs/api-docs/team-tokens) includes the same functionality as legacy team tokens, and allows you to provision multiple tokens per team.
302
+
299
303
## Generate a new team token
300
304
301
305
Generates a new team token and overrides existing token if one exists.
302
306
303
307
| Method | Path |
304
308
| :----- | :----------------------------------- |
305
-
| POST | /teams/:team_id/authentication-tokens|
309
+
| POST | /teams/:team_id/authentication-token|
306
310
307
-
This endpoint returns the secret text of the new authentication token. You can only access this token when you create it and can not recover it later.
311
+
This endpoint returns the secret text of the new authentication token. You can only access the secret when you create it and cannot recover it later.
0 commit comments