POST /organizations/:organization_name/authentication-token
:organization_name
The name of the organization to generate a token for.
Generates a new organization API token, replacing any existing token.
Only members of the owners team, the owners team API token, and the organization API token can access this endpoint.
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.
Request BodyThis POST endpoint requires a JSON object with the following properties as a request payload.
Key path Type Default Descriptiondata.type
string Must be "authentication-token"
. data.attributes.expired-at
string null
The UTC date and time that the Organization Token will expire, in ISO 8601 format. If omitted or set to null
the token will never expire. Sample Payload
{
"data": {
"type": "authentication-token",
"attributes": {
"expired-at": "2023-04-06T12:00:00.000Z"
}
}
}
Sample Request
curl \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/vnd.api+json" \
--request POST \
--data @payload.json \
https://app.terraform.io/api/v2/organizations/my-organization/authentication-token
Sample Response
{
"data": {
"id": "4111756",
"type": "authentication-tokens",
"attributes": {
"created-at": "2017-11-29T19:11:28.075Z",
"last-used-at": null,
"description": null,
"token": "ZgqYdzuvlv8Iyg.atlasv1.6nV7t1OyFls341jo1xdZTP72fN0uu9VL55ozqzekfmToGFbhoFvvygIRy2mwVAXomOE",
"expired-at": "2023-04-06T12:00:00.000Z"
},
"relationships": {
"created-by": {
"data": {
"id": "user-62goNpx1ThQf689e",
"type": "users"
}
}
}
}
}
DELETE /organizations/:organization/authentication-token
:organization_name
Which organization's token should be deleted.
Only members of the owners team, the owners team API token, and the organization API token can access this endpoint.
Sample Requestcurl \
--header "Authorization: Bearer $TOKEN" \
--header "Content-Type: application/vnd.api+json" \
--request DELETE \
https://app.terraform.io/api/v2/organizations/my-organization/authentication-token
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4