Class: Sanction

A live Sanction object. Every field from the API response is available directly on the object (e.g. sanction.type, sanction.reason), and the object also exposes action methods (update(), revoke(), watch()).

Extends

• SanctionResponse

Constructors

new Sanction()

new Sanction(
   ctx, 
   projectId, 
   data): Sanction

Internal

Parameters

Parameter	Type	Description
ctx	ClientContext	-
projectId	string	-
data	object	-
data.createdAt	string	Format: date-time Description Creation timestamp
data.createdByUserId?	string	Description User who created the sanction
data.endAt?	string	Format: date-time Description When sanction expires (null = permanent)
data.externalUserId?	string	Description External user ID
data.id	string	Description Sanction ID
data.isActive	boolean	Description Whether the sanction is currently active
data.metadata?	object	Description Additional metadata
data.participant?	object	Description Participant information (if available)
data.participant.displayName	string	Description Display name of the participant
data.participant.externalUserId	string	Description External user ID from ODIN
data.participant.id	string	Description Participant ID
data.participant.joinedAt?	string	Format: date-time Description When the participant first joined the project
data.participant.projectId	string	Description ODIN project ID this participant belongs to
data.participant.userData?	object	Description User data from ODIN (parsed JSON)
data.participantId?	string	Description Participant ID (if session-scoped)
data.reason?	string	Description Reason for sanction
data.revokedAt?	string	Format: date-time Description When sanction was revoked
data.revokedByUserId?	string	Description User who revoked the sanction
data.scope?	object	Description Scope configuration
data.sessionId?	string	Description Session ID (if session-scoped)
data.startAt	string	Format: date-time Description When sanction becomes active
data.status	string	Description Status: active, expired, or revoked
data.tenantId	string	Description Tenant ID
data.type	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Type of sanction
data.updatedAt	string	Format: date-time Description Last update timestamp

Returns

Sanction

Inherited from

SanctionResponse.constructor

Defined in

4Players/cortex-typescript-sdk/src/resources/sanctions.ts:174

Properties

Property	Type	Description	Inherited from	Defined in
createdAt	string	Format: date-time Description Creation timestamp	SanctionResponse.createdAt	4Players/cortex-typescript-sdk/src/types.ts:3086
createdByUserId?	string	Description User who created the sanction	SanctionResponse.createdByUserId	4Players/cortex-typescript-sdk/src/types.ts:3081
endAt?	string	Format: date-time Description When sanction expires (null = permanent)	SanctionResponse.endAt	4Players/cortex-typescript-sdk/src/types.ts:3079
externalUserId?	string	Description External user ID	SanctionResponse.externalUserId	4Players/cortex-typescript-sdk/src/types.ts:3052
id	string	Description Sanction ID	SanctionResponse.id	4Players/cortex-typescript-sdk/src/types.ts:3046
isActive	boolean	Description Whether the sanction is currently active	SanctionResponse.isActive	4Players/cortex-typescript-sdk/src/types.ts:3100
metadata?	object	Description Additional metadata	SanctionResponse.metadata	4Players/cortex-typescript-sdk/src/types.ts:3067
participant?	object	Description Participant information (if available)	SanctionResponse.participant	4Players/cortex-typescript-sdk/src/types.ts:3104
participant.displayName	string	Description Display name of the participant	-	4Players/cortex-typescript-sdk/src/types.ts:3031
participant.externalUserId	string	Description External user ID from ODIN	-	4Players/cortex-typescript-sdk/src/types.ts:3033
participant.id	string	Description Participant ID	-	4Players/cortex-typescript-sdk/src/types.ts:3027
participant.joinedAt?	string	Format: date-time Description When the participant first joined the project	-	4Players/cortex-typescript-sdk/src/types.ts:3042
participant.projectId	string	Description ODIN project ID this participant belongs to	-	4Players/cortex-typescript-sdk/src/types.ts:3029
participant.userData?	object	Description User data from ODIN (parsed JSON)	-	4Players/cortex-typescript-sdk/src/types.ts:3035
participantId?	string	Description Participant ID (if session-scoped)	SanctionResponse.participantId	4Players/cortex-typescript-sdk/src/types.ts:3050
reason?	string	Description Reason for sanction	SanctionResponse.reason	4Players/cortex-typescript-sdk/src/types.ts:3065
revokedAt?	string	Format: date-time Description When sanction was revoked	SanctionResponse.revokedAt	4Players/cortex-typescript-sdk/src/types.ts:3096
revokedByUserId?	string	Description User who revoked the sanction	SanctionResponse.revokedByUserId	4Players/cortex-typescript-sdk/src/types.ts:3098
scope?	object	Description Scope configuration	SanctionResponse.scope	4Players/cortex-typescript-sdk/src/types.ts:3061
sessionId?	string	Description Session ID (if session-scoped)	SanctionResponse.sessionId	4Players/cortex-typescript-sdk/src/types.ts:3054
startAt	string	Format: date-time Description When sanction becomes active	SanctionResponse.startAt	4Players/cortex-typescript-sdk/src/types.ts:3074
status	string	Description Status: active, expired, or revoked	SanctionResponse.status	4Players/cortex-typescript-sdk/src/types.ts:3102
tenantId	string	Description Tenant ID	SanctionResponse.tenantId	4Players/cortex-typescript-sdk/src/types.ts:3048
type	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Type of sanction	SanctionResponse.type	4Players/cortex-typescript-sdk/src/types.ts:3059
updatedAt	string	Format: date-time Description Last update timestamp	SanctionResponse.updatedAt	4Players/cortex-typescript-sdk/src/types.ts:3091

Accessors

data

get data(): object

The raw API response object.

Deprecated

The response fields are now available directly on this object (e.g. sanction.type instead of sanction.data.type). This accessor will be removed before the stable release.

Returns

object

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:3086
createdByUserId?	string	Description User who created the sanction	4Players/cortex-typescript-sdk/src/types.ts:3081
endAt?	string	Format: date-time Description When sanction expires (null = permanent)	4Players/cortex-typescript-sdk/src/types.ts:3079
externalUserId?	string	Description External user ID	4Players/cortex-typescript-sdk/src/types.ts:3052
id	string	Description Sanction ID	4Players/cortex-typescript-sdk/src/types.ts:3046
isActive	boolean	Description Whether the sanction is currently active	4Players/cortex-typescript-sdk/src/types.ts:3100
metadata?	object	Description Additional metadata	4Players/cortex-typescript-sdk/src/types.ts:3067
participant?	object	Description Participant information (if available)	4Players/cortex-typescript-sdk/src/types.ts:3104
participant.displayName	string	Description Display name of the participant	4Players/cortex-typescript-sdk/src/types.ts:3031
participant.externalUserId	string	Description External user ID from ODIN	4Players/cortex-typescript-sdk/src/types.ts:3033
participant.id	string	Description Participant ID	4Players/cortex-typescript-sdk/src/types.ts:3027
participant.joinedAt?	string	Format: date-time Description When the participant first joined the project	4Players/cortex-typescript-sdk/src/types.ts:3042
participant.projectId	string	Description ODIN project ID this participant belongs to	4Players/cortex-typescript-sdk/src/types.ts:3029
participant.userData?	object	Description User data from ODIN (parsed JSON)	4Players/cortex-typescript-sdk/src/types.ts:3035
participantId?	string	Description Participant ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3050
reason?	string	Description Reason for sanction	4Players/cortex-typescript-sdk/src/types.ts:3065
revokedAt?	string	Format: date-time Description When sanction was revoked	4Players/cortex-typescript-sdk/src/types.ts:3096
revokedByUserId?	string	Description User who revoked the sanction	4Players/cortex-typescript-sdk/src/types.ts:3098
scope?	object	Description Scope configuration	4Players/cortex-typescript-sdk/src/types.ts:3061
sessionId?	string	Description Session ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3054
startAt	string	Format: date-time Description When sanction becomes active	4Players/cortex-typescript-sdk/src/types.ts:3074
status	string	Description Status: active, expired, or revoked	4Players/cortex-typescript-sdk/src/types.ts:3102
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:3048
type	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Type of sanction	4Players/cortex-typescript-sdk/src/types.ts:3059
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:3091

Defined in

4Players/cortex-typescript-sdk/src/resources/sanctions.ts:187

Methods

revoke()

revoke(body): Promise<object>

Revoke this sanction

Parameters

Parameter	Type	Description
body	object	Revocation payload (optional reason)
body.reason?	string	Description Reason for revocation Example False positive from automated detection

Returns

Promise<object>

Revoked sanction

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:3086
createdByUserId?	string	Description User who created the sanction	4Players/cortex-typescript-sdk/src/types.ts:3081
endAt?	string	Format: date-time Description When sanction expires (null = permanent)	4Players/cortex-typescript-sdk/src/types.ts:3079
externalUserId?	string	Description External user ID	4Players/cortex-typescript-sdk/src/types.ts:3052
id	string	Description Sanction ID	4Players/cortex-typescript-sdk/src/types.ts:3046
isActive	boolean	Description Whether the sanction is currently active	4Players/cortex-typescript-sdk/src/types.ts:3100
metadata?	object	Description Additional metadata	4Players/cortex-typescript-sdk/src/types.ts:3067
participant?	object	Description Participant information (if available)	4Players/cortex-typescript-sdk/src/types.ts:3104
participant.displayName	string	Description Display name of the participant	4Players/cortex-typescript-sdk/src/types.ts:3031
participant.externalUserId	string	Description External user ID from ODIN	4Players/cortex-typescript-sdk/src/types.ts:3033
participant.id	string	Description Participant ID	4Players/cortex-typescript-sdk/src/types.ts:3027
participant.joinedAt?	string	Format: date-time Description When the participant first joined the project	4Players/cortex-typescript-sdk/src/types.ts:3042
participant.projectId	string	Description ODIN project ID this participant belongs to	4Players/cortex-typescript-sdk/src/types.ts:3029
participant.userData?	object	Description User data from ODIN (parsed JSON)	4Players/cortex-typescript-sdk/src/types.ts:3035
participantId?	string	Description Participant ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3050
reason?	string	Description Reason for sanction	4Players/cortex-typescript-sdk/src/types.ts:3065
revokedAt?	string	Format: date-time Description When sanction was revoked	4Players/cortex-typescript-sdk/src/types.ts:3096
revokedByUserId?	string	Description User who revoked the sanction	4Players/cortex-typescript-sdk/src/types.ts:3098
scope?	object	Description Scope configuration	4Players/cortex-typescript-sdk/src/types.ts:3061
sessionId?	string	Description Session ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3054
startAt	string	Format: date-time Description When sanction becomes active	4Players/cortex-typescript-sdk/src/types.ts:3074
status	string	Description Status: active, expired, or revoked	4Players/cortex-typescript-sdk/src/types.ts:3102
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:3048
type	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Type of sanction	4Players/cortex-typescript-sdk/src/types.ts:3059
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:3091

Defined in

4Players/cortex-typescript-sdk/src/resources/sanctions.ts:210

---

update()

update(body): Promise<object>

Update this sanction

Parameters

Parameter	Type	Description
body	object	Updated sanction data
body.endAt?	string	Description Updated end time
body.metadata?	object	Description Updated metadata
body.reason?	string	Description Updated reason
body.scope?	object	Description Updated scope configuration
body.type?	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Updated sanction type

Returns

Promise<object>

Updated sanction

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:3086
createdByUserId?	string	Description User who created the sanction	4Players/cortex-typescript-sdk/src/types.ts:3081
endAt?	string	Format: date-time Description When sanction expires (null = permanent)	4Players/cortex-typescript-sdk/src/types.ts:3079
externalUserId?	string	Description External user ID	4Players/cortex-typescript-sdk/src/types.ts:3052
id	string	Description Sanction ID	4Players/cortex-typescript-sdk/src/types.ts:3046
isActive	boolean	Description Whether the sanction is currently active	4Players/cortex-typescript-sdk/src/types.ts:3100
metadata?	object	Description Additional metadata	4Players/cortex-typescript-sdk/src/types.ts:3067
participant?	object	Description Participant information (if available)	4Players/cortex-typescript-sdk/src/types.ts:3104
participant.displayName	string	Description Display name of the participant	4Players/cortex-typescript-sdk/src/types.ts:3031
participant.externalUserId	string	Description External user ID from ODIN	4Players/cortex-typescript-sdk/src/types.ts:3033
participant.id	string	Description Participant ID	4Players/cortex-typescript-sdk/src/types.ts:3027
participant.joinedAt?	string	Format: date-time Description When the participant first joined the project	4Players/cortex-typescript-sdk/src/types.ts:3042
participant.projectId	string	Description ODIN project ID this participant belongs to	4Players/cortex-typescript-sdk/src/types.ts:3029
participant.userData?	object	Description User data from ODIN (parsed JSON)	4Players/cortex-typescript-sdk/src/types.ts:3035
participantId?	string	Description Participant ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3050
reason?	string	Description Reason for sanction	4Players/cortex-typescript-sdk/src/types.ts:3065
revokedAt?	string	Format: date-time Description When sanction was revoked	4Players/cortex-typescript-sdk/src/types.ts:3096
revokedByUserId?	string	Description User who revoked the sanction	4Players/cortex-typescript-sdk/src/types.ts:3098
scope?	object	Description Scope configuration	4Players/cortex-typescript-sdk/src/types.ts:3061
sessionId?	string	Description Session ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3054
startAt	string	Format: date-time Description When sanction becomes active	4Players/cortex-typescript-sdk/src/types.ts:3074
status	string	Description Status: active, expired, or revoked	4Players/cortex-typescript-sdk/src/types.ts:3102
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:3048
type	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Type of sanction	4Players/cortex-typescript-sdk/src/types.ts:3059
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:3091

Defined in

4Players/cortex-typescript-sdk/src/resources/sanctions.ts:196

---

watch()

watch(): DocumentSubscription<object>

Live-subscribe to this sanction. current reflects status changes including revocation (the object remains, with status updated).

Returns

DocumentSubscription<object>

A DocumentSubscription for this sanction

Name	Type	Description	Defined in
createdAt	string	Format: date-time Description Creation timestamp	4Players/cortex-typescript-sdk/src/types.ts:3086
createdByUserId?	string	Description User who created the sanction	4Players/cortex-typescript-sdk/src/types.ts:3081
endAt?	string	Format: date-time Description When sanction expires (null = permanent)	4Players/cortex-typescript-sdk/src/types.ts:3079
externalUserId?	string	Description External user ID	4Players/cortex-typescript-sdk/src/types.ts:3052
id	string	Description Sanction ID	4Players/cortex-typescript-sdk/src/types.ts:3046
isActive	boolean	Description Whether the sanction is currently active	4Players/cortex-typescript-sdk/src/types.ts:3100
metadata?	object	Description Additional metadata	4Players/cortex-typescript-sdk/src/types.ts:3067
participant?	object	Description Participant information (if available)	4Players/cortex-typescript-sdk/src/types.ts:3104
participant.displayName	string	Description Display name of the participant	4Players/cortex-typescript-sdk/src/types.ts:3031
participant.externalUserId	string	Description External user ID from ODIN	4Players/cortex-typescript-sdk/src/types.ts:3033
participant.id	string	Description Participant ID	4Players/cortex-typescript-sdk/src/types.ts:3027
participant.joinedAt?	string	Format: date-time Description When the participant first joined the project	4Players/cortex-typescript-sdk/src/types.ts:3042
participant.projectId	string	Description ODIN project ID this participant belongs to	4Players/cortex-typescript-sdk/src/types.ts:3029
participant.userData?	object	Description User data from ODIN (parsed JSON)	4Players/cortex-typescript-sdk/src/types.ts:3035
participantId?	string	Description Participant ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3050
reason?	string	Description Reason for sanction	4Players/cortex-typescript-sdk/src/types.ts:3065
revokedAt?	string	Format: date-time Description When sanction was revoked	4Players/cortex-typescript-sdk/src/types.ts:3096
revokedByUserId?	string	Description User who revoked the sanction	4Players/cortex-typescript-sdk/src/types.ts:3098
scope?	object	Description Scope configuration	4Players/cortex-typescript-sdk/src/types.ts:3061
sessionId?	string	Description Session ID (if session-scoped)	4Players/cortex-typescript-sdk/src/types.ts:3054
startAt	string	Format: date-time Description When sanction becomes active	4Players/cortex-typescript-sdk/src/types.ts:3074
status	string	Description Status: active, expired, or revoked	4Players/cortex-typescript-sdk/src/types.ts:3102
tenantId	string	Description Tenant ID	4Players/cortex-typescript-sdk/src/types.ts:3048
type	| "warn" | "mute" | "listen_only" | "text_only" | "rate_limit" | "shadow_mute" | "temp_ban" | "perm_ban" | "ranked_restriction" | "queue_delay" | "party_restriction" | "human_review"	Description Type of sanction	4Players/cortex-typescript-sdk/src/types.ts:3059
updatedAt	string	Format: date-time Description Last update timestamp	4Players/cortex-typescript-sdk/src/types.ts:3091

Defined in

4Players/cortex-typescript-sdk/src/resources/sanctions.ts:224