» Organization Token API

» Generate a new organization token

Generates a new organization token and overrides existing token if one exists.

Method Path
POST /organizations/:organization/authentication-token

» Parameters

  • :organization (string: <required>) - specifies the organization for the organization token

» Sample Request

curl \
  --header "Authorization: Bearer $ATLAS_TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  --request POST \
  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"
    },
    "relationships": {
      "created-by": {
        "data": {
          "id": "skierkowski",
          "type": "users"
        }
      }
    }
  }
}

» Delete the organization token

Method Path
DELETE /organizations/:organization/authentication-token

» Parameters

  • :organization (string: <required>) - specifies the organization for the organization token

» Sample Request

curl \
  --header "Authorization: Bearer $ATLAS_TOKEN" \
  --header "Content-Type: application/vnd.api+json" \
  --request DELETE \
  https://app.terraform.io/api/v2/organizations/my-organization/authentication-token