> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Defense.com

> How to set up the Defense.com connector, plus the actions that are available.

![Defense.com](https://stackone-logos.com/api/defense/filled/svg)

Betav0.1.0[See changelog](https://docs.stackone.com/connectors/defense/changelog.md)

[22 actions](#actions) · 1 auth method

Security

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [API Key · Connector Profile](https://docs.stackone.com/connectors/defense/guides/connector-profile/api-key.md)
>
> Requires a Company Admin to create an API key in the Defense.com account settings. Keys carry a mandatory expiry date an...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [API Key · Link Account](https://docs.stackone.com/connectors/defense/guides/link-account/api-key.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Scopes

Select all
|
Clear

Read

Write

No scopes found

22 actions

ActionDescriptionRequired scopes

List Companies`defense_list_companies`

List the client companies managed under a partner account.

`Read`

Get Company`defense_get_company`

Retrieve a single managed client company.

`Read`

Create Company`defense_create_company`

Create a client company under a partner account.

`Write`

Attach Managed Company Source Document`defense_attach_managed_company_source_document`

Attach a document to an external threat source on a managed company.

`Write`

List Threat Detections`defense_list_threat_detections`

List the individual detection events rolled up under a threat.

`Read`

Attach External Source Document`defense_attach_external_source_document`

Attach a report-level document to an external threat source.

`Write`

Create Managed Company Threat`defense_create_managed_company_threat`

Create a threat on a managed client company.

`Write`

List Threat Notes`defense_list_threat_notes`

Retrieve all investigation notes on a threat.

`Read`

Create Threat Note`defense_create_threat_note`

Add an investigation note to a threat.

`Write`

Update Threat Note`defense_update_threat_note`

Update an existing note on a threat.

`Write`

List Packages`defense_list_packages`

List the product packages available to a partner.

`Read`

List Threat Remediations`defense_list_threat_remediations`

List the remediation actions attached to a threat.

`Read`

Get Threat Remediation`defense_get_threat_remediation`

Retrieve a single remediation on a threat.

`Read`

Update Threat Remediation`defense_update_threat_remediation`

Update a remediation's assignee or state.

`Write`

List Threat Assets`defense_list_threat_assets`

List the assets affected by a threat.

`Read`

List Threat Detection Assets`defense_list_threat_detection_assets`

List the assets affected by a specific detection.

`Read`

List Threat Detection Users`defense_list_threat_detection_users`

List the users affected by a specific detection.

`Read`

List Threat Users`defense_list_threat_users`

List the users affected by a threat.

`Read`

List Threats`defense_list_threats`

Retrieve a paginated list of threats detected on the account.

`Read`

Get Threat`defense_get_threat`

Retrieve a single threat by its identifier.

`Read`

Create Threat`defense_create_threat`

Create or aggregate a threat from an external security source.

`Write`

Update Threat`defense_update_threat`

Update a threat's remediation assignment or state.

`Write`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.