Generates a new secondary API token.
You have access to most of the Chat API with just a secondary API token, except the functionality to manage the tokens including listing, generating, or revoking. Such functionality is only for the master API token.
The master API token has access to all the functionalities of secondary API tokens, in addition to managing all the API tokens. The maximum number of secondary API tokens you can manage is 10. This means you can have up to 11 API tokens including the master API token.
Note: It is recommended that you use secondary API tokens when making API calls. This is because using the master API token may accidentally revoke secondary tokens and lead your API calls to not work.
The following table lists the properties of an HTTP request that this action supports.
Required
Property name | Type | Description |
---|---|---|
HTTP_API_TOKEN | string | Specifies the master API token of the application. |
If successful, this action returns the information about the generated secondary API token in the response body.
In the case of an error, an error object is returned. A detailed list of error codes is available here.