Page tree

Outdated release! Latest docs are Release 8.7: API AccessTokens Create v4


For the latest updates on available API endpoints and documentation, see

This is the latest version of the APIs.


Create an access token for the authenticated user. 

  • Access tokens can be used for managing more secure access to the APIs. For more information, see API Authentication.
  • Access tokens can be created via the Trifacta® application or via API. 

Version:  v4

Required Permissions

NOTE: Each request to the Trifacta® platform must include authentication credentials. See API Authentication.


Request Type: POST



Request Header:

  • If you do not have a valid access token to use at this time, you must submit a username/password combination as part of the Authentication header. 
  • If you have a valid access token, you can submit that token in your Authentication header with this request.
  • For more information, see API Authentication

Request Body:


  "lifetimeSeconds": 100,
  "description": "My 100-second token"


Response Status Code - Success:  201 - Created

NOTE: If you receive a Route doesn't exist error message, please verify that the API access token feature has been enabled in your instance of the platform. For more information, see Enable API Access Tokens.

Response Body Example:

    "tokenValue": "eyJ0b2tlbklkIjoiYmFiOTA4ZjctZGNjMi00OTYyLTg1YmQtYzFlOTZkMGNhY2JkIiwic2VjcmV0IjoiOWIyNjQ5MWJiODM4ZWY0OWE1NzdhYzYxOWEwYTFkNjc4ZmE4NmE5MzBhZWFiZDk3OGRlOTY0ZWI0MDUyODhiOCJ9",
    "tokenInfo": {
        "tokenId": "bab908f7-dcc2-4962-85bd-c1e96d0cacbd",
        "description": "My 100-second token",
        "expiredAt": "2019-01-16T00:06:41.743Z",
        "lastUsed": null,
        "createdAt": "2019-01-16T00:05:01.743Z"


Request reference:


Lifetime in seconds for the access token.

Set this value to -1 to create a non-expiring token.

descriptionUser-friendly description of the token

Response reference:

The token itself.

NOTE: This value must be retained and provided with each subsequent request for the user.


Internal identifier for the token.

NOTE: This value is unique within this instance of the platform. When performing requests on a specific token, its tokenId must be provided as the object identifier.

tokenInfo.descriptionUser-friendly description for the access token

Timestamp for when the access token expires.

null value indicates that the access token never expires.


Timestamp for when the access token was last used.

null value indicates that the access token has never been used.

tokenInfo.createdAtTimestamp for when the access token was created

This page has no comments.