servers/add_tokens

Create authentication tokens that are associated with a specific system. These tokens may be used to submit information to TrueCommand via the “external” namespace of API calls.

NOTE: Administrator access only - all others will get a 403/Forbidden error

• Required:
  • “tvid” (string) : System ID for where to generate auth tokens
  • “name” (string or Json Array of strings) : Nickname(s) for the tokens to create. These should generally be useful for the user to remember what they were using the token for.
    • The names given here must be unique. This API will not overwrite existing tokens if the name was already created previously.

ARGUMENTS ONLY: See the basics of API requests for additional formatting information.

{
  "tvid" : "server_id_1",
  "names" : "token_4"
}

{
  "result" : "success",
  "tokens" : {
    "token_1" : "XXXXXXXXXXXXX",
    "token_2" : "YYYYYYYYYYYYY",
    "token_3" : "ZZZZZZZZZZZZZZ",
    "token_4" : "ABCDEFGHIJKLMNOP",
  }
}

This API call will emit a “servers/list_tokens” event to notify other administrators of the change. See the servers/list_tokens API reference for details.

This API call does not generate a detailed log summary item

• servers/list_tokens
• servers/remove_tokens