Vault Export api changes to add first used timestamp column in query period docs change

content/vault/v1.21.x (rc)/content/api-docs/system/internal-counters.mdx

@@ -1322,6 +1322,16 @@ $ curl \
     http://127.0.0.1:8200/v1/sys/internal/counters/activity/export
 ```
 
+### Response fields
+
+- `token_creation_time` - the creation time of the token used by the client to
+  perform the request (previously `timestamp`). Token creation time is distinct
+  from the time the client was created and may lie outside of the queried time
+  period.
+
+- `client_first_usage_time` - timestamp representing the earliest usage of the
+  client during the queried time period.
+
 ### Sample JSON response
 
 The entity alias names for userpass in the sample response records below are user-provided. They are
@@ -1354,7 +1364,8 @@ single line.
   "mount_accessor": "auth_userpass_a005db73",
   "mount_type": "userpass",
   "mount_path": "auth/userpass/",
-  "timestamp": "2024-07-10T09:33:51Z",
+  "token_creation_time": "2022-07-10T09:33:51Z",
+  "client_first_used_time":"2024-08-03T12:00:00Z",
   "policies": [
     "secret-read",
     "secret-list",
@@ -1386,7 +1397,8 @@ single line.
   "mount_accessor": "auth_ns_token_e3119312",
   "mount_type": "ns_token",
   "mount_path": "auth/token/",
-  "timestamp": "2024-07-08T11:35:23Z",
+  "token_creation_time": "2022-07-08T11:35:23Z",
+  "client_first_used_time":"2024-08-03T12:00:00Z",
   "policies": [],
   "entity_metadata": {},
   "entity_alias_metadata": {},
@@ -1405,7 +1417,8 @@ single line.
   "mount_accessor": "auth_ldap_a005db73",
   "mount_type": "ldap",
   "mount_path": "auth/ldap/",
-  "timestamp": "2024-07-08T11:47:57Z",
+  "token_creation_time": "2022-07-08T11:47:57Z",
+  "client_first_used_time":"2024-08-03T12:00:00Z",
   "policies": [
     "secret-read"
   ],
@@ -1432,7 +1445,8 @@ single line.
   "mount_accessor": "auth_userpass_01a6ea85",
   "mount_type": "userpass",
   "mount_path": "auth/userpass/",
-  "timestamp": "2024-07-21T14:51:36Z",
+  "token_creation_time": "2022-07-21T14:51:36Z",
+  "client_first_used_time":"2024-08-03T12:00:00Z",
   "policies": [
     "secret-read"
   ],
@@ -1458,7 +1472,8 @@ single line.
   "mount_accessor": "auth_kubernetes_b596406f",
   "mount_type": "kubernetes",
   "mount_path": "auth/kubernetes/",
-  "timestamp": "2024-07-10T09:33:51Z",
+  "token_creation_time": "2022-07-10T09:33:51Z",
+  "client_first_used_time":"2024-08-03T12:00:00Z",
   "policies": [
     "secret-read"
   ],
@@ -1484,7 +1499,8 @@ single line.
   "mount_accessor": "auth_aws_c223ff01",
   "mount_type": "aws",
   "mount_path": "auth/aws/",
-  "timestamp": "2024-07-10T09:33:51Z",
+  "token_creation_time": "2022-07-10T09:33:51Z",
+  "client_first_used_time":"2024-08-03T12:00:00Z",
   "policies": [
     "secret-read"
   ],
@@ -1505,16 +1521,16 @@ will be named using the field name and underlying index (e.g. `policies.0`, `pol
 (e.g. `entity_metadata.email_address`, `entity_alias_metadata.region`). A flattened field will only be added if at least one record contains
 it. If a top-level field (e.g. `entity_metadata`) is not populated in any of the
 records then there will not be any flattened fields of prefix
-`enttiy_metadata.`.
+`entity_metadata.`.
 
 <CodeBlockConfig hideClipboard>
 
 ```text
-entity_name,entity_alias_name,client_id,client_type,local_entity_alias,namespace_id,namespace_path,mount_accessor,mount_path,mount_type,timestamp,entity_alias_custom_metadata.contact_email,entity_alias_custom_metadata.group,entity_alias_custom_metadata.region,entity_metadata.email_address,entity_group_ids.0,policies.0,policies.1,policies.2,policies.4
-admin,admin,3f210722-7210-98e8-1f0d-e6a39ffb29c6,entity,false,root,,auth_userpass_a005db73,auth/userpass/,userpass,2024-07-10T09:33:51Z,admin@example.com,san_francisco,west,admin@example.com,746fbaf9-ffeb-62b9-7f0b-42d79ca0883f,secret-read,secret-list,secret-write,secret-delete
-,,590198f7-9178-57d6-c345-48746bb438d8,non-entity-token,false,YWZzu,ns1/a/,auth_ns_token_e3119312,auth/token/,ns_token,2024-07-08T11:35:23Z,,,,,,,,,
-jdoe,jdoe,665a54bf-8652-c0c5-8121-40adf0d9786a,entity,false,wOsmr,ns1/a,auth_ldap_a005db73,auth/ldap/,ldap,2024-07-08T11:47:57Z,jdoe@example.com,new_york,east,,9f18cd4a-4e64-a2b2-b001-7b6b0dfb1270,secret-read,,,
-jdoe,jdoe,0640a8f0-b315-cc8a-c0c2-713f663774df,entity,false,oIiGy,ns1/b,auth_userpass_01a6ea85,auth/userpass/,userpass,2024-07-21T14:51:36Z,,new_york,east,,76a374a1-72fd-30ca-2455-f51dfeaa805e,secret-read,,,
+entity_name,entity_alias_name,client_id,client_type,local_entity_alias,namespace_id,namespace_path,mount_accessor,mount_path,mount_type,token_creation_time,client_first_used_time,entity_alias_custom_metadata.contact_email,entity_alias_custom_metadata.group,entity_alias_custom_metadata.region,entity_metadata.email_address,entity_group_ids.0,policies.0,policies.1,policies.2,policies.4
+admin,admin,3f210722-7210-98e8-1f0d-e6a39ffb29c6,entity,false,root,,auth_userpass_a005db73,auth/userpass/,userpass,2022-07-10T09:33:51Z,2024-08-03T12:00:00Z,admin@example.com,san_francisco,west,admin@example.com,746fbaf9-ffeb-62b9-7f0b-42d79ca0883f,secret-read,secret-list,secret-write,secret-delete
+,,590198f7-9178-57d6-c345-48746bb438d8,non-entity-token,false,YWZzu,ns1/a/,auth_ns_token_e3119312,auth/token/,ns_token,2022-07-08T11:35:23Z,2024-08-03T12:00:00Z,,,,,,,,
+jdoe,jdoe,665a54bf-8652-c0c5-8121-40adf0d9786a,entity,false,wOsmr,ns1/a,auth_ldap_a005db73,auth/ldap/,ldap,2022-07-08T11:47:57Z,2024-08-03T12:00:00Z,jdoe@example.com,new_york,east,,9f18cd4a-4e64-a2b2-b001-7b6b0dfb1270,secret-read,,,
+jdoe,jdoe,0640a8f0-b315-cc8a-c0c2-713f663774df,entity,false,oIiGy,ns1/b,auth_userpass_01a6ea85,auth/userpass/,userpass,2022-07-21T14:51:36Z,2024-08-03T12:00:00Z,,new_york,east,,76a374a1-72fd-30ca-2455-f51dfeaa805e,secret-read,,,
 ```
 
 </CodeBlockConfig>