Page tree

Release 6.8.2



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 Designer Cloud® application or via API. 

Version:  v4

Required Permissions

NOTE: Each request to the Designer Cloud Powered by Trifacta® platform must include authentication credentials. See


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.