@rebornteam/reborn-api 2.5.1 → 2.6.4

package/docs/AdminPlayerDetailResponse.md

@@ -0,0 +1,37 @@
+# AdminPlayerDetailResponse
+
+Full player detail including punishment history and all known usernames
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **number** | Internal player ID | [optional] [default to undefined]
+**uuid** | **string** | Player Minecraft UUID | [optional] [default to undefined]
+**username** | **string** | Most recently seen username | [optional] [default to undefined]
+**firstJoin** | **boolean** | Whether this player still has first-join status | [optional] [default to undefined]
+**firstLogin** | **string** | Timestamp of first connection (ISO-8601) | [optional] [default to undefined]
+**lastUsedAt** | **string** | Timestamp of most recent connection (ISO-8601) | [optional] [default to undefined]
+**punishmentPointsRaw** | **number** | Raw punishment score | [optional] [default to undefined]
+**punishmentPointsPercent** | **number** | Punishment score as a percentage | [optional] [default to undefined]
+**usernameHistory** | [**Array<AdminUsernameHistoryEntry>**](AdminUsernameHistoryEntry.md) | All usernames this player has used, newest first | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPlayerDetailResponse } from '@rebornteam/reborn-api';
+
+const instance: AdminPlayerDetailResponse = {
+    id,
+    uuid,
+    username,
+    firstJoin,
+    firstLogin,
+    lastUsedAt,
+    punishmentPointsRaw,
+    punishmentPointsPercent,
+    usernameHistory,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPlayerSearchResult.md

@@ -0,0 +1,23 @@
+# AdminPlayerSearchResult
+
+Lightweight player reference used in search results and punishment evaluations
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**uuid** | **string** | Player Minecraft UUID | [optional] [default to undefined]
+**username** | **string** | Most recently seen username, null if never recorded | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPlayerSearchResult } from '@rebornteam/reborn-api';
+
+const instance: AdminPlayerSearchResult = {
+    uuid,
+    username,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPlayerSummary.md

@@ -0,0 +1,35 @@
+# AdminPlayerSummary
+
+Summary of a player record, used in list views
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **number** | Internal player ID | [optional] [default to undefined]
+**uuid** | **string** | Player Minecraft UUID | [optional] [default to undefined]
+**username** | **string** | Most recently seen username, null if never recorded | [optional] [default to undefined]
+**firstJoin** | **boolean** | Whether this player still has first-join status | [optional] [default to undefined]
+**firstLogin** | **string** | Timestamp of first connection (ISO-8601) | [optional] [default to undefined]
+**lastUsedAt** | **string** | Timestamp of most recent connection (ISO-8601) | [optional] [default to undefined]
+**punishmentPointsRaw** | **number** | Raw punishment score (sum of weighted punishment values) | [optional] [default to undefined]
+**punishmentPointsPercent** | **number** | Punishment score as a percentage. Values above 100 indicate future punishments should be permanent. | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPlayerSummary } from '@rebornteam/reborn-api';
+
+const instance: AdminPlayerSummary = {
+    id,
+    uuid,
+    username,
+    firstJoin,
+    firstLogin,
+    lastUsedAt,
+    punishmentPointsRaw,
+    punishmentPointsPercent,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPlayersApi.md

@@ -0,0 +1,122 @@
+# AdminPlayersApi
+
+All URIs are relative to *https://api.smsh.sh*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**getPlayer**](#getplayer) | **GET** /admin/player/{uuid} | Get player detail|
+|[**listPlayers**](#listplayers) | **GET** /admin/player | List players|
+
+# **getPlayer**
+> AdminPlayerDetailResponse getPlayer()
+
+Returns full detail for a single player including all known usernames and punishment scoring.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let uuid: string; //Player Minecraft UUID (default to undefined)
+
+const { status, data } = await apiInstance.getPlayer(
+    uuid
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **uuid** | [**string**] | Player Minecraft UUID | defaults to undefined|
+
+
+### Return type
+
+**AdminPlayerDetailResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Player detail retrieved successfully |  -  |
+|**404** | Player not found |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Administrator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **listPlayers**
+> AdminPagedPlayerResponse listPlayers()
+
+Returns up to 500 players ordered by most recently seen. Optionally filter by UUID or username substring.
+
+### Example
+
+```typescript
+import {
+    AdminPlayersApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPlayersApi(configuration);
+
+let page: number; //Page number (1-indexed) (default to 1)
+let limit: number; //Page size (default to 50)
+let search: string; //Optional search string matched against UUID or username (case-insensitive substring) (optional) (default to undefined)
+
+const { status, data } = await apiInstance.listPlayers(
+    page,
+    limit,
+    search
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **page** | [**number**] | Page number (1-indexed) | defaults to 1|
+| **limit** | [**number**] | Page size | defaults to 50|
+| **search** | [**string**] | Optional search string matched against UUID or username (case-insensitive substring) | (optional) defaults to undefined|
+
+
+### Return type
+
+**AdminPagedPlayerResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Player list retrieved successfully |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Administrator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/AdminPunishmentDraftResponse.md

@@ -0,0 +1,21 @@
+# AdminPunishmentDraftResponse
+
+Batch punishment draft — one evaluation per target
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**evaluations** | [**Array<AdminPunishmentEvaluation>**](AdminPunishmentEvaluation.md) | Ordered list of evaluations, one per target in the request | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPunishmentDraftResponse } from '@rebornteam/reborn-api';
+
+const instance: AdminPunishmentDraftResponse = {
+    evaluations,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPunishmentEvaluation.md

@@ -0,0 +1,39 @@
+# AdminPunishmentEvaluation
+
+Evaluation of a punishment\'s impact on a single target
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**target** | [**AdminPunishmentTarget**](AdminPunishmentTarget.md) | The target this evaluation applies to | [optional] [default to undefined]
+**affectedPlayers** | [**Array<AdminPlayerSearchResult>**](AdminPlayerSearchResult.md) | Players affected — one player for UUID targets, all players on the IP for connection targets | [optional] [default to undefined]
+**currentScore** | **number** | Current punishment score before applying this punishment (0–100+) | [optional] [default to undefined]
+**pointsToAdd** | **number** | Points this punishment would add to the score | [optional] [default to undefined]
+**newScore** | **number** | Projected score after applying this punishment | [optional] [default to undefined]
+**willBePermanent** | **boolean** | Whether this punishment would be permanent based on the current score threshold | [optional] [default to undefined]
+**durationSeconds** | **number** | Resolved duration in seconds — null if permanent or a WARNING | [optional] [default to undefined]
+**previousPunishmentCount** | **number** | Number of existing punishments on this target | [optional] [default to undefined]
+**isConnectionTarget** | **boolean** | True when the target is an IP address (connection punishment) rather than a player UUID | [optional] [default to undefined]
+**effectiveType** | **string** | The effective punishment type that will be applied — may differ from the requested type if escalated to BAN at threshold | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPunishmentEvaluation } from '@rebornteam/reborn-api';
+
+const instance: AdminPunishmentEvaluation = {
+    target,
+    affectedPlayers,
+    currentScore,
+    pointsToAdd,
+    newScore,
+    willBePermanent,
+    durationSeconds,
+    previousPunishmentCount,
+    isConnectionTarget,
+    effectiveType,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPunishmentListItem.md

@@ -0,0 +1,42 @@
+# AdminPunishmentListItem
+
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**id** | **number** |  | [default to undefined]
+**reason** | **string** |  | [default to undefined]
+**notes** | **string** |  | [optional] [default to undefined]
+**type** | **string** |  | [default to undefined]
+**severity** | **number** |  | [default to undefined]
+**createdBy** | **string** |  | [default to undefined]
+**expiresAt** | **string** |  | [optional] [default to undefined]
+**createdAt** | **string** |  | [default to undefined]
+**targetType** | **string** |  | [default to undefined]
+**targetUuid** | **string** |  | [optional] [default to undefined]
+**targetUsername** | **string** |  | [optional] [default to undefined]
+**targetIp** | **string** |  | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPunishmentListItem } from '@rebornteam/reborn-api';
+
+const instance: AdminPunishmentListItem = {
+    id,
+    reason,
+    notes,
+    type,
+    severity,
+    createdBy,
+    expiresAt,
+    createdAt,
+    targetType,
+    targetUuid,
+    targetUsername,
+    targetIp,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPunishmentSearchResponse.md

@@ -0,0 +1,25 @@
+# AdminPunishmentSearchResponse
+
+Result of a punishment target search — either a list of matching players or a list of matching IP addresses
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**kind** | **string** | Search kind — \'player\' for UUID/username searches, \'ip\' for IP address searches | [optional] [default to undefined]
+**players** | [**Array<AdminPlayerSearchResult>**](AdminPlayerSearchResult.md) | Matching players — only populated when kind=\'player\' | [optional] [default to undefined]
+**ipResults** | [**Array<AdminIpSearchResult>**](AdminIpSearchResult.md) | Matching IP addresses with their associated players — only populated when kind=\'ip\' | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPunishmentSearchResponse } from '@rebornteam/reborn-api';
+
+const instance: AdminPunishmentSearchResponse = {
+    kind,
+    players,
+    ipResults,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPunishmentTarget.md

@@ -0,0 +1,23 @@
+# AdminPunishmentTarget
+
+A target for a punishment — either a player UUID or an IP address (mutually exclusive)
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**uuid** | **string** | Player Minecraft UUID | [optional] [default to undefined]
+**ipAddress** | **string** | IP address — when specified, the punishment is linked to the connection record and all players on that IP are shown as affected | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminPunishmentTarget } from '@rebornteam/reborn-api';
+
+const instance: AdminPunishmentTarget = {
+    uuid,
+    ipAddress,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/AdminPunishmentsApi.md

@@ -0,0 +1,248 @@
+# AdminPunishmentsApi
+
+All URIs are relative to *https://api.smsh.sh*
+
+|Method | HTTP request | Description|
+|------------- | ------------- | -------------|
+|[**applyPunishment**](#applypunishment) | **POST** /admin/punishment/apply | Apply punishment|
+|[**createDraft**](#createdraft) | **POST** /admin/punishment/draft | Evaluate punishment impact|
+|[**getPunishments**](#getpunishments) | **GET** /admin/punishment | List punishments|
+|[**searchTargets**](#searchtargets) | **GET** /admin/punishment/search | Search punishment targets|
+
+# **applyPunishment**
+> AdminApplyPunishmentResponse applyPunishment(adminApplyPunishmentRequest)
+
+Apply a punishment to one or more targets. Player targets are linked via player_punishment; IP targets are linked via connection_punishment. The authenticated user is recorded as the issuer.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration,
+    AdminApplyPunishmentRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+let adminApplyPunishmentRequest: AdminApplyPunishmentRequest; //
+
+const { status, data } = await apiInstance.applyPunishment(
+    adminApplyPunishmentRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminApplyPunishmentRequest** | **AdminApplyPunishmentRequest**|  | |
+
+
+### Return type
+
+**AdminApplyPunishmentResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Punishments applied successfully |  -  |
+|**400** | Invalid request |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Administrator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **createDraft**
+> AdminPunishmentDraftResponse createDraft(adminCreatePunishmentDraftRequest)
+
+Preview the impact of a punishment across one or more targets. Returns current score, points to add, projected new score, and affected players per target. No changes are made.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration,
+    AdminCreatePunishmentDraftRequest
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+let adminCreatePunishmentDraftRequest: AdminCreatePunishmentDraftRequest; //
+
+const { status, data } = await apiInstance.createDraft(
+    adminCreatePunishmentDraftRequest
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **adminCreatePunishmentDraftRequest** | **AdminCreatePunishmentDraftRequest**|  | |
+
+
+### Return type
+
+**AdminPunishmentDraftResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: application/json
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Evaluation results |  -  |
+|**400** | Invalid request |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Administrator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **getPunishments**
+> AdminPagedPunishmentResponse getPunishments()
+
+Returns a paginated list of punishments with optional filtering by player UUID, username, IP address, type, and date range.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+let page: number; //Page number (1-indexed) (default to 1)
+let limit: number; //Page size (default to 50)
+let uuid: string; //Filter by player UUID (optional) (default to undefined)
+let username: string; //Filter by player username (case-insensitive substring match) (optional) (default to undefined)
+let ipAddress: string; //Filter by IP address (optional) (default to undefined)
+let type: Array<string>; //Filter by punishment type (BAN, MUTE, WARNING). Repeatable. (optional) (default to undefined)
+let issuedAfter: number; //Filter punishments issued after this epoch timestamp (ms) (optional) (default to undefined)
+let issuedBefore: number; //Filter punishments issued before this epoch timestamp (ms) (optional) (default to undefined)
+
+const { status, data } = await apiInstance.getPunishments(
+    page,
+    limit,
+    uuid,
+    username,
+    ipAddress,
+    type,
+    issuedAfter,
+    issuedBefore
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **page** | [**number**] | Page number (1-indexed) | defaults to 1|
+| **limit** | [**number**] | Page size | defaults to 50|
+| **uuid** | [**string**] | Filter by player UUID | (optional) defaults to undefined|
+| **username** | [**string**] | Filter by player username (case-insensitive substring match) | (optional) defaults to undefined|
+| **ipAddress** | [**string**] | Filter by IP address | (optional) defaults to undefined|
+| **type** | **Array&lt;string&gt;** | Filter by punishment type (BAN, MUTE, WARNING). Repeatable. | (optional) defaults to undefined|
+| **issuedAfter** | [**number**] | Filter punishments issued after this epoch timestamp (ms) | (optional) defaults to undefined|
+| **issuedBefore** | [**number**] | Filter punishments issued before this epoch timestamp (ms) | (optional) defaults to undefined|
+
+
+### Return type
+
+**AdminPagedPunishmentResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Punishment list retrieved successfully |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Administrator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+
+# **searchTargets**
+> AdminPunishmentSearchResponse searchTargets()
+
+Search for players by UUID or username, or look up all players associated with an IP address. Used to populate the target table before issuing a punishment.
+
+### Example
+
+```typescript
+import {
+    AdminPunishmentsApi,
+    Configuration
+} from '@rebornteam/reborn-api';
+
+const configuration = new Configuration();
+const apiInstance = new AdminPunishmentsApi(configuration);
+
+let q: string; //UUID, username, or partial/full IP address to search for (default to undefined)
+
+const { status, data } = await apiInstance.searchTargets(
+    q
+);
+```
+
+### Parameters
+
+|Name | Type | Description  | Notes|
+|------------- | ------------- | ------------- | -------------|
+| **q** | [**string**] | UUID, username, or partial/full IP address to search for | defaults to undefined|
+
+
+### Return type
+
+**AdminPunishmentSearchResponse**
+
+### Authorization
+
+[DiscordAuth](../README.md#DiscordAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+|**200** | Search results |  -  |
+|**401** | Unauthorized |  -  |
+|**403** | Forbidden - Administrator role required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)
+

package/docs/AdminUsernameHistoryEntry.md

@@ -0,0 +1,23 @@
+# AdminUsernameHistoryEntry
+
+A single entry in a player\'s username history
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**username** | **string** | The username at this point in time | [optional] [default to undefined]
+**changedAt** | **string** | When this username was first observed (ISO-8601) | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminUsernameHistoryEntry } from '@rebornteam/reborn-api';
+
+const instance: AdminUsernameHistoryEntry = {
+    username,
+    changedAt,
+};
+```
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

package/docs/ClientCredentialRequest.md

@@ -8,6 +8,7 @@ Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
 **name** | **string** | Human-readable name for the client | [default to undefined]
 **description** | **string** | Optional description of the client\'s purpose | [optional] [default to undefined]
+**expiresAt** | **string** | Optional expiration timestamp (ISO-8601). Null means the credential never expires. | [optional] [default to undefined]
 
 ## Example
 
@@ -17,6 +18,7 @@ import { ClientCredentialRequest } from '@rebornteam/reborn-api';
 const instance: ClientCredentialRequest = {
     name,
     description,
+    expiresAt,
 };
 ```
 

package/docs/ConnectionApi.md

@@ -48,7 +48,7 @@ const { status, data } = await apiInstance.getConnectionDetails(
 
 ### Authorization
 
-[CognitoAuth](../README.md#CognitoAuth)
+[DiscordAuth](../README.md#DiscordAuth)
 
 ### HTTP request headers