Skip to main content

Interface: RedTeamService

Defined in: src/airs/types.ts:551

Contract for AI Red Team scan operations.

Methods

abortScan()

abortScan(jobId): Promise<void>

Defined in: src/airs/types.ts:655

Abort a running scan.

Parameters

jobId

string

Returns

Promise<void>


acceptEula()

acceptEula(eulaContent): Promise<EulaStatus>

Defined in: src/airs/types.ts:557

Accept the EULA.

Parameters

eulaContent

string

Returns

Promise<EulaStatus>


createAdapter()

createAdapter(request, validate?): Promise<RedTeamAdapterDetail>

Defined in: src/airs/types.ts:715

Parameters

request

RedTeamAdapterCreateRequest

validate?

boolean

Returns

Promise<RedTeamAdapterDetail>


createChannel()

createChannel(request): Promise<RedTeamChannel>

Defined in: src/airs/types.ts:693

Create a network broker channel.

Parameters

request

RedTeamChannelCreateRequest

Returns

Promise<RedTeamChannel>


createDevices()

createDevices(tenantId, request): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:568

Create devices for an instance.

Parameters

tenantId

string

request

Record<string, unknown>

Returns

Promise<Record<string, unknown>>


createInstance()

createInstance(request): Promise<InstanceResponse>

Defined in: src/airs/types.ts:560

Create an instance.

Parameters

request

InstanceRequest

Returns

Promise<InstanceResponse>


createScan()

createScan(request): Promise<RedTeamJob>

Defined in: src/airs/types.ts:624

Create a red team scan job.

Parameters

request
attackGoals?

string[]

categories?

Record<string, unknown>

customPromptSets?

string[]

jobType

string

name

string

streamBreadth?

number

streamDepth?

number

targetUuid

string

Returns

Promise<RedTeamJob>


createTarget()

createTarget(request, opts?): Promise<RedTeamTargetDetail>

Defined in: src/airs/types.ts:596

Create a red team target.

Parameters

request

RedTeamTargetCreateRequest

opts?

TargetOperationOptions

Returns

Promise<RedTeamTargetDetail>


deleteAdapter()

deleteAdapter(uuid): Promise<void>

Defined in: src/airs/types.ts:725

Parameters

uuid

string

Returns

Promise<void>


deleteDevices()

deleteDevices(tenantId, serialNumbers): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:578

Delete devices by serial numbers.

Parameters

tenantId

string

serialNumbers

string

Returns

Promise<Record<string, unknown>>


deleteInstance()

deleteInstance(tenantId): Promise<InstanceResponse>

Defined in: src/airs/types.ts:566

Delete an instance.

Parameters

tenantId

string

Returns

Promise<InstanceResponse>


deleteTarget()

deleteTarget(uuid): Promise<void>

Defined in: src/airs/types.ts:609

Delete a red team target.

Parameters

uuid

string

Returns

Promise<void>


getAdapter()

getAdapter(uuid): Promise<RedTeamAdapterDetail>

Defined in: src/airs/types.ts:714

Parameters

uuid

string

Returns

Promise<RedTeamAdapterDetail>


getCategories()

getCategories(): Promise<RedTeamCategory[]>

Defined in: src/airs/types.ts:676

List available attack categories.

Returns

Promise<RedTeamCategory[]>


getChannel()

getChannel(channelId): Promise<RedTeamChannel>

Defined in: src/airs/types.ts:691

Get a network broker channel by ID.

Parameters

channelId

string

Returns

Promise<RedTeamChannel>


getChannelStats()

getChannelStats(): Promise<RedTeamChannelStats>

Defined in: src/airs/types.ts:697

Get network broker channel statistics.

Returns

Promise<RedTeamChannelStats>


getCustomReport()

getCustomReport(jobId): Promise<RedTeamCustomReport>

Defined in: src/airs/types.ts:664

Get custom attack report.

Parameters

jobId

string

Returns

Promise<RedTeamCustomReport>


getDynamicReport()

getDynamicReport(jobId): Promise<RedTeamDynamicReport>

Defined in: src/airs/types.ts:661

Get dynamic scan report.

Parameters

jobId

string

Returns

Promise<RedTeamDynamicReport>


getEulaContent()

getEulaContent(): Promise<EulaContent>

Defined in: src/airs/types.ts:553

Get EULA content.

Returns

Promise<EulaContent>


getEulaStatus()

getEulaStatus(): Promise<EulaStatus>

Defined in: src/airs/types.ts:555

Get EULA acceptance status.

Returns

Promise<EulaStatus>


getInstance()

getInstance(tenantId): Promise<InstanceDetail>

Defined in: src/airs/types.ts:562

Get instance details.

Parameters

tenantId

string

Returns

Promise<InstanceDetail>


getLanguages()

getLanguages(management?): Promise<RedTeamLanguages>

Defined in: src/airs/types.ts:700

List tenant languages (data plane, or management plane when management).

Parameters

management?

boolean

Returns

Promise<RedTeamLanguages>


getRegistryCredentials()

getRegistryCredentials(): Promise<RegistryCredentials>

Defined in: src/airs/types.ts:580

Get or create registry credentials.

Returns

Promise<RegistryCredentials>


getScan()

getScan(jobId): Promise<RedTeamJob>

Defined in: src/airs/types.ts:636

Get scan status by job ID.

Parameters

jobId

string

Returns

Promise<RedTeamJob>


getStaticReport()

getStaticReport(jobId): Promise<RedTeamStaticReport>

Defined in: src/airs/types.ts:658

Get static scan report.

Parameters

jobId

string

Returns

Promise<RedTeamStaticReport>


getTarget()

getTarget(uuid): Promise<RedTeamTargetDetail>

Defined in: src/airs/types.ts:593

Get target details.

Parameters

uuid

string

Returns

Promise<RedTeamTargetDetail>


getTargetMetadata()

getTargetMetadata(): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:585

Get target field metadata.

Returns

Promise<Record<string, unknown>>


getTargetProfile()

getTargetProfile(uuid): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:615

Get target profile.

Parameters

uuid

string

Returns

Promise<Record<string, unknown>>


getTargetProfileErrorLogs()

getTargetProfileErrorLogs(targetId, opts?): Promise<{ logs: RedTeamErrorLog[]; totalItems?: number; }>

Defined in: src/airs/types.ts:702

List target-profile error logs.

Parameters

targetId

string

opts?
limit?

number

offset?

number

string

Returns

Promise<{ logs: RedTeamErrorLog[]; totalItems?: number; }>


getTargetTemplates()

getTargetTemplates(): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:587

Get provider-specific target templates.

Returns

Promise<Record<string, unknown>>


listAdapters()

listAdapters(opts?): Promise<{ adapters: RedTeamAdapterListItem[]; totalItems?: number; }>

Defined in: src/airs/types.ts:708

Parameters

opts?

RedTeamAdapterListOptions

Returns

Promise<{ adapters: RedTeamAdapterListItem[]; totalItems?: number; }>


listAllAdapters()

listAllAdapters(opts?): Promise<RedTeamAdapterListItem[]>

Defined in: src/airs/types.ts:711

Parameters

opts?

RedTeamAdapterListOptions & object

Returns

Promise<RedTeamAdapterListItem[]>


listAllChannels()

listAllChannels(opts?): Promise<RedTeamChannel[]>

Defined in: src/airs/types.ts:689

Parameters

opts?

RedTeamChannelListOptions & object

Returns

Promise<RedTeamChannel[]>


listAllScans()

listAllScans(opts?): Promise<RedTeamJob[]>

Defined in: src/airs/types.ts:646

Parameters

opts?
jobType?

string

limit?

number

max?

number

status?

string

targetId?

string

Returns

Promise<RedTeamJob[]>


listAttacks()

listAttacks(jobId, opts?): Promise<{ attacks: RedTeamAttack[]; totalItems?: number; }>

Defined in: src/airs/types.ts:667

List attacks from a static/dynamic scan.

Parameters

jobId

string

opts?
limit?

number

severity?

string

Returns

Promise<{ attacks: RedTeamAttack[]; totalItems?: number; }>


listChannels()

listChannels(opts?): Promise<{ channels: RedTeamChannel[]; totalItems?: number; }>

Defined in: src/airs/types.ts:686

List network broker channels.

Parameters

opts?

RedTeamChannelListOptions

Returns

Promise<{ channels: RedTeamChannel[]; totalItems?: number; }>


listCustomAttacks()

listCustomAttacks(jobId, opts?): Promise<RedTeamCustomAttack[]>

Defined in: src/airs/types.ts:673

List attacks from a custom prompt set scan.

Parameters

jobId

string

opts?
limit?

number

Returns

Promise<RedTeamCustomAttack[]>


listScans()

listScans(opts?): Promise<RedTeamJob[]>

Defined in: src/airs/types.ts:639

List recent scans with optional filters.

Parameters

opts?
jobType?

string

limit?

number

offset?

number

status?

string

targetId?

string

Returns

Promise<RedTeamJob[]>


listTargets()

listTargets(): Promise<RedTeamTarget[]>

Defined in: src/airs/types.ts:590

List configured red team targets.

Returns

Promise<RedTeamTarget[]>


probeTarget()

probeTarget(request): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:612

Probe a target connection.

Parameters

request

Record<string, unknown>

Returns

Promise<Record<string, unknown>>


updateAdapter()

updateAdapter(uuid, overrides, validate?): Promise<RedTeamAdapterDetail>

Defined in: src/airs/types.ts:720

Read-modify-write: merges overrides onto the current record (upstream PUT is full-replacement).

Parameters

uuid

string

overrides

RedTeamAdapterUpdateOverrides

validate?

boolean

Returns

Promise<RedTeamAdapterDetail>


updateChannel()

updateChannel(channelId, request): Promise<RedTeamChannel>

Defined in: src/airs/types.ts:695

Update a network broker channel.

Parameters

channelId

string

request

RedTeamChannelUpdateRequest

Returns

Promise<RedTeamChannel>


updateDevices()

updateDevices(tenantId, request): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:573

Update devices (PATCH).

Parameters

tenantId

string

request

Record<string, unknown>

Returns

Promise<Record<string, unknown>>


updateInstance()

updateInstance(tenantId, request): Promise<InstanceResponse>

Defined in: src/airs/types.ts:564

Update an instance.

Parameters

tenantId

string

request

InstanceRequest

Returns

Promise<InstanceResponse>


updateTarget()

updateTarget(uuid, request, opts?): Promise<RedTeamTargetDetail>

Defined in: src/airs/types.ts:602

Update a red team target.

Parameters

uuid

string

request

RedTeamTargetUpdateRequest

opts?

TargetOperationOptions

Returns

Promise<RedTeamTargetDetail>


updateTargetProfile()

updateTargetProfile(uuid, request): Promise<Record<string, unknown>>

Defined in: src/airs/types.ts:618

Update target profile.

Parameters

uuid

string

request

Record<string, unknown>

Returns

Promise<Record<string, unknown>>


validateAdapter()

validateAdapter(request): Promise<RedTeamAdapterValidationResult>

Defined in: src/airs/types.ts:727

Run a script end-to-end through the broker channel; returns an execution outcome.

Parameters

request

RedTeamAdapterValidateRequest

Returns

Promise<RedTeamAdapterValidationResult>


validateTargetAuth()

validateTargetAuth(request): Promise<TargetAuthValidationResult>

Defined in: src/airs/types.ts:583

Validate target auth credentials.

Parameters

request

TargetAuthValidationRequest

Returns

Promise<TargetAuthValidationResult>


waitForCompletion()

waitForCompletion(jobId, onProgress?, intervalMs?): Promise<RedTeamJob>

Defined in: src/airs/types.ts:679

Poll until scan completes. Calls onProgress for status updates.

Parameters

jobId

string

onProgress?

(job) => void

intervalMs?

number

Returns

Promise<RedTeamJob>