Skip to main content

Interface: RedTeamService

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

Contract for AI Red Team scan operations.

Methods​

abortScan()​

abortScan(jobId): Promise<void>

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

Abort a running scan.

Parameters​

jobId​

string

Returns​

Promise<void>


acceptEula()​

acceptEula(eulaContent): Promise<EulaStatus>

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

Accept the EULA.

Parameters​

eulaContent​

string

Returns​

Promise<EulaStatus>


createAdapter()​

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

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

Parameters​

request​

RedTeamAdapterCreateRequest

validate?​

boolean

Returns​

Promise<RedTeamAdapterDetail>


createChannel()​

createChannel(request): Promise<RedTeamChannel>

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

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:569

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:561

Create an instance.

Parameters​

request​

InstanceRequest

Returns​

Promise<InstanceResponse>


createScan()​

createScan(request): Promise<RedTeamJob>

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

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:597

Create a red team target.

Parameters​

request​

RedTeamTargetCreateRequest

opts?​

TargetOperationOptions

Returns​

Promise<RedTeamTargetDetail>


deleteAdapter()​

deleteAdapter(uuid): Promise<void>

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

Parameters​

uuid​

string

Returns​

Promise<void>


deleteDevices()​

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

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

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:567

Delete an instance.

Parameters​

tenantId​

string

Returns​

Promise<InstanceResponse>


deleteTarget()​

deleteTarget(uuid): Promise<void>

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

Delete a red team target.

Parameters​

uuid​

string

Returns​

Promise<void>


getAdapter()​

getAdapter(uuid): Promise<RedTeamAdapterDetail>

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

Parameters​

uuid​

string

Returns​

Promise<RedTeamAdapterDetail>


getCategories()​

getCategories(): Promise<RedTeamCategory[]>

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

List available attack categories.

Returns​

Promise<RedTeamCategory[]>


getChannel()​

getChannel(channelId): Promise<RedTeamChannel>

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

Get a network broker channel by ID.

Parameters​

channelId​

string

Returns​

Promise<RedTeamChannel>


getChannelStats()​

getChannelStats(): Promise<RedTeamChannelStats>

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

Get network broker channel statistics.

Returns​

Promise<RedTeamChannelStats>


getCustomReport()​

getCustomReport(jobId): Promise<RedTeamCustomReport>

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

Get custom attack report.

Parameters​

jobId​

string

Returns​

Promise<RedTeamCustomReport>


getDynamicReport()​

getDynamicReport(jobId): Promise<RedTeamDynamicReport>

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

Get dynamic scan report.

Parameters​

jobId​

string

Returns​

Promise<RedTeamDynamicReport>


getEulaContent()​

getEulaContent(): Promise<EulaContent>

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

Get EULA content.

Returns​

Promise<EulaContent>


getEulaStatus()​

getEulaStatus(): Promise<EulaStatus>

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

Get EULA acceptance status.

Returns​

Promise<EulaStatus>


getInstance()​

getInstance(tenantId): Promise<InstanceDetail>

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

Get instance details.

Parameters​

tenantId​

string

Returns​

Promise<InstanceDetail>


getLanguages()​

getLanguages(management?): Promise<RedTeamLanguages>

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

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:581

Get or create registry credentials.

Returns​

Promise<RegistryCredentials>


getScan()​

getScan(jobId): Promise<RedTeamJob>

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

Get scan status by job ID.

Parameters​

jobId​

string

Returns​

Promise<RedTeamJob>


getStaticReport()​

getStaticReport(jobId): Promise<RedTeamStaticReport>

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

Get static scan report.

Parameters​

jobId​

string

Returns​

Promise<RedTeamStaticReport>


getTarget()​

getTarget(uuid): Promise<RedTeamTargetDetail>

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

Get target details.

Parameters​

uuid​

string

Returns​

Promise<RedTeamTargetDetail>


getTargetMetadata()​

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

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

Get target field metadata.

Returns​

Promise<Record<string, unknown>>


getTargetProfile()​

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

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

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:703

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:588

Get provider-specific target templates.

Returns​

Promise<Record<string, unknown>>


listAdapters()​

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

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

Parameters​

opts?​

RedTeamAdapterListOptions

Returns​

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


listAllAdapters()​

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

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

Parameters​

opts?​

RedTeamAdapterListOptions & object

Returns​

Promise<RedTeamAdapterListItem[]>


listAllChannels()​

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

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

Parameters​

opts?​

RedTeamChannelListOptions & object

Returns​

Promise<RedTeamChannel[]>


listAllScans()​

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

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

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:668

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:687

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:674

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:640

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:591

List configured red team targets.

Returns​

Promise<RedTeamTarget[]>


probeTarget()​

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

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

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:721

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:696

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:574

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:565

Update an instance.

Parameters​

tenantId​

string

request​

InstanceRequest

Returns​

Promise<InstanceResponse>


updateTarget()​

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

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

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:619

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:728

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:584

Validate target auth credentials.

Parameters​

request​

TargetAuthValidationRequest

Returns​

Promise<TargetAuthValidationResult>


waitForCompletion()​

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

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

Poll until scan completes. Calls onProgress for status updates.

Parameters​

jobId​

string

onProgress?​

(job) => void

intervalMs?​

number

Returns​

Promise<RedTeamJob>