servers/list_tokens
1 minute read.
Last Modified 2021-02-04 11:38 ESTNamespace | Name | Admin Only | Log Summary | Generates Event | Version Added |
---|---|---|---|---|---|
servers | list_tokens | yes | no | no | 1.1 |
List all the current authentication tokens which are associated with a specific system. These are tokens that may be used to submit system information via the “external” namespace of API calls, and are associated with a specific system registration.
NOTE: Administrator access only - non-administrators will receive a 403/Forbidden error
- Required:
- “tvid” (string) : System ID for which to return current auth tokens
- Optional:
- none ({})
ARGUMENTS ONLY: See the basics of API requests for additional formatting information.
{
"tvid" : "system_id_1"
}
{
"tokens" : {
"token_1" : "XXXXXXXXXXXXX",
"token_2" : "YYYYYYYYYYYYY",
"token_3" : "ZZZZZZZZZZZZZZ"
}
}
This API call does not emit any middleware events of it’s own. Any modification of the available tokens will emit a “servers/list_tokens” event to notify other administrators of the change.
{
"namespace" : "event",
"name" : "servers/list_tokens",
"id" : "",
"args" : {
"tvid" : "system_id_1"
}
}
This API call does not generate a detailed log summary item