@rebornteam/reborn-api 2.6.0 → 2.7.0

package/dist/esm/base.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/base.js

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/common.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/common.js

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/configuration.js

@@ -3,7 +3,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/esm/index.js

@@ -4,7 +4,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/dist/index.js

@@ -5,7 +5,7 @@
  * Reborn API
  * The Reborn API serves as the central backend for the platform, orchestrating secure communication between game clients and data services. This API supports two authentication methods: - **OAuth 2.0 Client Credentials**: For programmatic API access - **Discord SSO Bearer Token**: For admin endpoints requiring Discord authentication
  *
- * The version of the OpenAPI document: 2.6.0
+ * The version of the OpenAPI document: 2.7.0
  *
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).

package/docs/AdminApplyPunishmentRequest.md

@@ -0,0 +1,33 @@
+# AdminApplyPunishmentRequest
+
+Request to apply a punishment to one or more targets
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**targets** | [**Array<AdminPunishmentTarget>**](AdminPunishmentTarget.md) | List of targets to punish — each must have either a uuid or ipAddress | [default to undefined]
+**type** | **string** | Punishment type | [default to undefined]
+**severity** | **number** | Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical | [optional] [default to undefined]
+**reason** | **string** | Reason for the punishment | [default to undefined]
+**durationSeconds** | **number** | Custom duration in seconds — if omitted the suggested duration for the type and severity is used | [optional] [default to undefined]
+**forcePermanent** | **boolean** | Force the punishment to be permanent regardless of the target\'s current score | [optional] [default to false]
+**notes** | **string** | Internal notes visible only to administrators — not shown to the punished player | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminApplyPunishmentRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminApplyPunishmentRequest = {
+    targets,
+    type,
+    severity,
+    reason,
+    durationSeconds,
+    forcePermanent,
+    notes,
+};
+```
+
+[[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/AdminApplyPunishmentResponse.md

@@ -0,0 +1,21 @@
+# AdminApplyPunishmentResponse
+
+Batch punishment apply result — one result per target
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**results** | [**Array<AdminApplyPunishmentResult>**](AdminApplyPunishmentResult.md) | Ordered list of results, one per target in the request | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminApplyPunishmentResponse } from '@rebornteam/reborn-api';
+
+const instance: AdminApplyPunishmentResponse = {
+    results,
+};
+```
+
+[[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/AdminApplyPunishmentResult.md

@@ -0,0 +1,33 @@
+# AdminApplyPunishmentResult
+
+Result of applying a punishment to a single target
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**target** | [**AdminPunishmentTarget**](AdminPunishmentTarget.md) | The target this result applies to | [optional] [default to undefined]
+**punishmentId** | **number** | ID of the created punishment record | [optional] [default to undefined]
+**type** | **string** | Punishment type applied | [optional] [default to undefined]
+**severity** | **number** | Severity level applied | [optional] [default to undefined]
+**newScore** | **number** | Updated punishment score after applying | [optional] [default to undefined]
+**isPermanent** | **boolean** | Whether the punishment was made permanent | [optional] [default to undefined]
+**expiresAt** | **string** | When the punishment expires — null if permanent or a WARNING | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminApplyPunishmentResult } from '@rebornteam/reborn-api';
+
+const instance: AdminApplyPunishmentResult = {
+    target,
+    punishmentId,
+    type,
+    severity,
+    newScore,
+    isPermanent,
+    expiresAt,
+};
+```
+
+[[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/AdminCreatePunishmentDraftRequest.md

@@ -0,0 +1,31 @@
+# AdminCreatePunishmentDraftRequest
+
+Request to evaluate the impact of a punishment across one or more targets before applying
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**targets** | [**Array<AdminPunishmentTarget>**](AdminPunishmentTarget.md) | List of targets to evaluate — each must have either a uuid or ipAddress | [default to undefined]
+**type** | **string** | Punishment type | [default to undefined]
+**severity** | **number** | Severity level: 1=Minor, 2=Moderate, 3=Severe, 4=Critical | [optional] [default to undefined]
+**reason** | **string** | Reason for the punishment (not used in evaluation, required for apply) | [default to undefined]
+**durationSeconds** | **number** | Custom duration in seconds — if omitted the suggested duration for the type and severity is used | [optional] [default to undefined]
+**forcePermanent** | **boolean** | Force the punishment to be permanent regardless of the target\'s current score | [optional] [default to false]
+
+## Example
+
+```typescript
+import { AdminCreatePunishmentDraftRequest } from '@rebornteam/reborn-api';
+
+const instance: AdminCreatePunishmentDraftRequest = {
+    targets,
+    type,
+    severity,
+    reason,
+    durationSeconds,
+    forcePermanent,
+};
+```
+
+[[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/AdminIpSearchResult.md

@@ -0,0 +1,23 @@
+# AdminIpSearchResult
+
+A single IP address match in a punishment search, with all players ever seen on that IP
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**ipAddress** | **string** | IP address | [optional] [default to undefined]
+**players** | [**Array<AdminPlayerSearchResult>**](AdminPlayerSearchResult.md) | Players ever seen on this IP | [optional] [default to undefined]
+
+## Example
+
+```typescript
+import { AdminIpSearchResult } from '@rebornteam/reborn-api';
+
+const instance: AdminIpSearchResult = {
+    ipAddress,
+    players,
+};
+```
+
+[[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/AdminPagedPunishmentResponse.md

@@ -6,7 +6,7 @@ Paginated punishment list response
 
 Name | Type | Description | Notes
 ------------ | ------------- | ------------- | -------------
-**data** | [**Array<PunishmentGetPunishmentResponse>**](PunishmentGetPunishmentResponse.md) | Punishments on the current page | [optional] [default to undefined]
+**data** | [**Array<AdminPunishmentListItem>**](AdminPunishmentListItem.md) | Punishments on the current page | [optional] [default to undefined]
 **total** | **number** | Total number of punishments matching the filters | [optional] [default to undefined]
 **page** | **number** | Current page (1-indexed) | [optional] [default to undefined]
 **limit** | **number** | Page size | [optional] [default to undefined]

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/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

@@ -4,7 +4,120 @@ 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()
@@ -27,7 +140,7 @@ 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, KICK, WARNING). Repeatable. (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)
 
@@ -52,7 +165,7 @@ const { status, data } = await apiInstance.getPunishments(
 | **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, KICK, WARNING). Repeatable. | (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|
 
@@ -80,3 +193,56 @@ const { status, data } = await apiInstance.getPunishments(
 
 [[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)
+