---
title: Upwind Security
slug: connectors/upwind-security
createdAt: 2026-11-16T09:02:31.407Z
---

Upwind Security provides cloud-native security solutions for monitoring, detecting, and responding to threats across cloud infrastructure and workloads.

Upwind Security is a cloud-native security platform that provides advanced threat detection, policy management, and automated response for modern cloud environments. This connector enables seamless integration with Upwind Security, allowing Swimlane Turbine users to automate the management of malware indicators, security policies, rule definitions, and incident stories. By leveraging this integration, security teams can orchestrate bulk operations, streamline policy enforcement, and accelerate threat response workflows directly within their low-code automation playbooks. The connector empowers organizations to maintain up-to-date threat intelligence, enforce consistent security controls, and rapidly remediate risks across their cloud infrastructure.

### Limitations

- None to date.

### Supported Versions

- This Upwind Security connector uses the v2 API.

### Additional Documents

- Documentation [Upwind Security](https://docs.upwind.io/restapi/v2/introduction)

## Configuration

### Prerequisites

Before using the Upwind Security connector, ensure you have the following prerequisites:

- OAuth 2.0 Client Credentials authentication, which requires:
  - URL: The base endpoint for accessing the Upwind Security API.
  - Client ID: The unique identifier for your application registered with Upwind Security.
  - Client Secret: The secret key associated with your client ID for secure authentication.

## Authentication Methods

- URL: The regional API endpoint for your Upwind organization. Use `https://api.upwind.io` for the US region, `https://api.eu.upwind.io` for the EU region, or `https://api.me.upwind.io` for the ME region. This URL is also sent as the OAuth audience.
- Client ID: The client ID generated in the Upwind console.
- Client Secret: The client secret generated with the client ID.

The connector requests an access token from `https://auth.upwind.io/oauth/token` with the client credentials grant. The audience must match the regional API URL configured above.

## Capabilities

This Upwind Security connector provides the following capabilities:

- Bulk Create Malware Indicators
- Bulk Create Policies
- Bulk Create Policy Rules
- Bulk Create Rule Definitions
- Bulk Delete Malware Indicators
- Bulk Delete Policies
- Bulk Delete Policy Rules
- Bulk Delete Rule Definitions
- Bulk Delete Stories
- Bulk Edit Policies
- Bulk Edit Policy Rules
- Bulk Edit Rule Definitions
- Bulk Update Stories
- Create an Indicator Datasets
- Delete an Indicator Dataset
  *... and so on*

### Bulk Create Malware Indicators

- This action creates multiple malware file hash indicators.[Click Here](https://docs.upwind.io/restapi/v2/create-malware-indicators)

### Bulk Create Policies

- This action creates multiple policies.[Click Here](https://docs.upwind.io/restapi/v2/bulk-create-policies)

### Bulk Create Policy Rules

- This action attaches multiple rule definitions to the policy.[Click Here](https://docs.upwind.io/restapi/v2/bulk-attach-rule-definitions)

### Bulk Create Rule Definitions

- This action creates multiple rule definitions.[Click Here](https://docs.upwind.io/restapi/v2/bulk-create-rule-definitions)

### Bulk Delete Malware Indicators

- This action removes multiple malware file hash indicators by hash and hash type.[Click Here](https://docs.upwind.io/restapi/v2/delete-malware-indicators)

### Bulk Delete Policies

- This action removes multiple policies and their rule attachments.[Click Here](https://docs.upwind.io/restapi/v2/bulk-delete-policies)

### Bulk Delete Policy Rules

- This action detaches multiple rule definitions from the policy.[Click Here](https://docs.upwind.io/restapi/v2/bulk-delete-policy-rules)

### Bulk Delete Rule Definitions

- This action removes multiple rule definitions and their policy attachments.[Click Here](https://docs.upwind.io/restapi/v2/bulk-delete-rule-definitions)

### Bulk Delete Stories

- This action permanently removes the stories and cannot be undone.[Click Here](https://docs.upwind.io/restapi/v2/delete-stories)

### Bulk Edit Policies

- This action updates multiple policies. If any policy in the request is not found or fails validation, no updates areapplied.[Click Here](https://docs.upwind.io/restapi/v2/bulk-edit-policies)

### Bulk Edit Policy Rules

- This action updates multiple policy rules.[Click Here](https://docs.upwind.io/restapi/v2/bulk-edit-policy-rules)

### Bulk Edit Rule Definitions

- This action updates multiple rule definitions.[Click Here](https://docs.upwind.io/restapi/v2/bulk-edit-rule-definitions)

### Bulk Update Stories

- This action updates the status of multiple stories.[Click Here](https://docs.upwind.io/restapi/v2/update-stories)

### Create an Indicator Datasets

- Creates a new indicator dataset from an uploaded JSON file (including STIX 2.1 bundles) and its metadata.[Click Here](https://docs.upwind.io/restapi/v2/create-indicator-dataset)

### Delete an Indicator Dataset

- This action deletes the indicator dataset and all of its versions. [Click Here](https://docs.upwind.io/restapi/v2/delete-indicator-dataset)

### Download a Threat Agent Skill

- This action returns that skill as a zip archive (application/zip).[Click Here](https://docs.upwind.io/restapi/v2/download-threat-skill)

### Get a Findings

- This action returns detailed information about a specific Configuration Finding.[Click Here](https://docs.upwind.io/restapi/v2/get-finding)

### Get a Policy

- Returns detailed information about a specific policy.[Click Here](https://docs.upwind.io/restapi/v2/get-policy)

### Get a Policy Rule

- This action returns detailed information about a specific policy rule.[Click Here](https://docs.upwind.io/restapi/v2/get-policy-rule)

### Get a Rule Definition

- This action returns detailed information about a specific rule definition.[Click Here](https://docs.upwind.io/restapi/v2/get-rule-definition)

### Get a Story

- This action returns detailed information about a specific story.[Click Here](https://docs.upwind.io/restapi/v2/get-story)

### Get an Indicator Datasets

- This action returns the latest version of a specific indicator dataset, including its Base64-encoded content. [Click Here](https://docs.upwind.io/restapi/v2/get-indicator-dataset)

### Get policies a rule definition is attach to

- This action returns the list of policies this rule definition is attached to, with per-attachment effective values (severity, scope, scope\_type, is\_enabled, is\_suspended).[Click Here](https://docs.upwind.io/restapi/v2/get-attached-policies)

### List Stories

- This action returns a list of story objects that are associated with the specified organization.[Click Here](https://docs.upwind.io/restapi/v2/list-stories)

### List Threat Agent Skills

- This action returns a list of the Agent Skill objects published for threats, each with its name, description, and version.[Click Here](https://docs.upwind.io/restapi/v2/list-threat-skills)

### Search Findings

- This action returns a list of Configuration Finding objects matching the supplied search conditions. [Click Here](https://docs.upwind.io/restapi/v2/search-findings)

### Search Indicator Datasets

- This action returns a filtered list of indicator dataset objects that are associated with the specified organizationbased on the specified search criteria.[Click Here](https://docs.upwind.io/restapi/v2/search-indicator-datasets)

### Search Malware Indicators

- This action returns a paginated list of malware file hash indicators matching the specified filter conditions.[ClickHere](https://docs.upwind.io/restapi/v2/search-malware-indicators)

### Search Policies

- Search endpoint returns a filtered list of policy objects that are associated with the specified organization based on the specified search criteria.[Click Here](https://docs.upwind.io/restapi/v2/search-policies)

### Search Policy Rules

- This action returns a filtered list of policy rule objects for the specified policy, based on the given search criteria.[Click Here](https://docs.upwind.io/restapi/v2/search-policy-rules)

### Search Rule Definitions

- This action returns a filtered list of rule definition objects that are associated with the specified organization based on the specified search criteria.[Click Here](https://docs.upwind.io/restapi/v2/search-rule-definitions)

### Search Stories

- This action returns a filtered list of story objects that are associated with the specified organization based on the specified search criteria.[Click Here](https://docs.upwind.io/restapi/v2/search-stories)

### Update an Indicator Dataset

- This action updates the indicator dataset's description and/or tags without creating a new version.[Click Here](https://docs.upwind.io/restapi/v2/update-indicator-dataset-metadata)

### Upload a New Indicator Dataset Version

- The dataset's name stores the uploaded file as a new version of the indicator dataset, optionally updating its metadata.[Click Here](https://docs.upwind.io/restapi/v2/update-indicator-dataset-content)

# Configurations

## Oauth 2.0 Client Credentials

Authenticates using oauth 2.0 client credentials

### Configuration Parameters

| **Parameter**  | **Description**                    | **Type** | **Required** |
| -------------- | ---------------------------------- | -------- | ------------ |
| url            | A URL to the target host.          | string   | Required     |
| token\_url     |                                    | string   | Optional     |
| client\_id     | The client ID                      | string   | Required     |
| client\_secret | The client secret.                 | string   | Required     |
| scope          | Permission scopes for this action. | array    | Optional     |
| verify\_ssl    | Verify SSL certificate             | boolean  | Optional     |
| http\_proxy    | A proxy to route requests through. | string   | Optional     |

# Actions

## Bulk Create Malware Indicators

Create multiple malware file hash indicators for a specified organization in Upwind Security using a list of items.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/malware/bulk`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                               |
| --------------------------------- | -------- | ------------ | ------------------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.            |
| `items`                           | array    | Optional     | Parameter for Bulk Create Malware Indicators                  |
| `items.action`                    | string   | Required     | The verdict this override forces for the hash.                |
| `items.hash`                      | string   | Required     | The file hash this override applies to.                       |
| `items.hash_type`                 | string   | Required     | The algorithm used to compute the hash.                       |
| `items.reason`                    | string   | Optional     | A free-text explanation for why this override is being added. |

### Input Example

`{"json_body":{"items":[{"action":"allow","hash":"1234567890","hash_type":"sha1","reason":"test"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**       | **Type** | **Description**                                          |
| ------------------- | -------- | -------------------------------------------------------- |
| `status_code`       | number   | The HTTP status code returned by the API.                |
| `reason`            | string   | The HTTP reason phrase returned with the status code.    |
| `items`             | array    | The malware indicators that were created.                |
| `items.action`      | string   | The verdict this override forces for the hash.           |
| `items.added_by`    | string   | The identity that created this indicator.                |
| `items.create_time` | string   | The time the indicator was created.                      |
| `items.hash`        | string   | The file hash this override applies to.                  |
| `items.hash_type`   | string   | The algorithm used to compute the hash.                  |
| `items.reason`      | string   | A free-text explanation for why this override was added. |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Bulk Create Policies

Create multiple security policies in Upwind Security by specifying the organization ID and a list of policy definitions.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/bulk`
- **Method:** `POST`

### Input

| **Argument Name**                            | **Type** | **Required** | **Description**                           |
| -------------------------------------------- | -------- | ------------ | ----------------------------------------- |
| `path_parameters.organization_id`            | string   | Required     | The ID of the organization.               |
| `policies`                                   | array    | Optional     | The list of policies to create.           |
| `policies.default_severity`                  | string   | Required     | The default severity of this policy.      |
| `policies.is_enabled`                        | boolean  | Required     | Whether this policy is enabled.           |
| `policies.metadata`                          | object   | Required     | The display metadata of this policy.      |
| `policies.metadata.detection_description`    | string   | Required     | The detection description of this policy. |
| `policies.metadata.detection_title`          | string   | Required     | The detection title of this policy.       |
| `policies.name`                              | string   | Required     | The name of this policy.                  |
| `policies.resource_scope`                    | object   | Required     | The resource scope of this policy.        |
| `policies.resource_scope.condition`          | object   | Optional     | Parameter for Bulk Create Policies        |
| `policies.resource_scope.condition.operator` | string   | Optional     | The match operator.                       |
| `policies.resource_scope.condition.type`     | string   | Optional     | The type of the condition.                |
| `policies.resource_scope.condition.value`    | array    | Optional     | The values to match against.              |
| `policies.source_type`                       | string   | Required     | The telemetry source type of this policy. |

### Input Example

`{"json_body":{"policies":[{"default_severity":"low","is_enabled":true,"metadata":{"detection_description":"Surfaces role or permission changes that grant elevated access.","detection_title":"Privilege Escalation Attempt"},"name":"Cloudtrail Management Exposure Violations Testing","resource_scope":{"condition":{"operator":"equals","type":"cloud_account_ou_rule","value":["cloud_logs"]}},"source_type":"cloud_logs"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                             | **Type** | **Description**                                                    |
| ----------------------------------------- | -------- | ------------------------------------------------------------------ |
| `status_code`                             | number   | The HTTP status code returned by the API.                          |
| `reason`                                  | string   | The HTTP reason phrase returned with the status code.              |
| `items`                                   | array    | The policies that were created.                                    |
| `items.policy_id`                         | string   | The unique identifier of the policy.                               |
| `items.name`                              | string   | The name of this policy.                                           |
| `items.source_type`                       | string   | The telemetry source type of this policy.                          |
| `items.severity`                          | string   | The severity of this policy.                                       |
| `items.resource_scope`                    | object   | The resource scope of this policy.                                 |
| `items.resource_scope.condition`          | object   | The condition that defines which resources this policy applies to. |
| `items.resource_scope.condition.type`     | string   | The type of the condition.                                         |
| `items.resource_scope.condition.operator` | string   | The match operator.                                                |
| `items.resource_scope.condition.value`    | array    | The values to match against.                                       |
| `items.metadata`                          | object   | The display metadata of this policy.                               |
| `items.metadata.detection_title`          | string   | The detection title of this policy.                                |
| `items.metadata.detection_description`    | string   | The detection description of this policy.                          |
| `items.is_enabled`                        | boolean  | Whether this policy is enabled.                                    |
| `items.creator_id`                        | string   | The identity that created this policy.                             |
| `items.last_modifier_id`                  | string   | The identity that last modified this policy.                       |
| `items.create_time`                       | string   | The time the policy was created.                                   |
| `items.update_time`                       | string   | The time the policy was last updated.                              |

### Output Example

`{"status_code":201,"response_headers":{"Date":"Wed, 28 Oct 2026 13:16:28 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"e5c19f2979c2232aeb7478565de8f153","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Bulk Create Policy Rules

Attach multiple rule definitions to a specified policy in Upwind Security using organization and policy identifiers.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/{{policy_id}}/rules/bulk`
- **Method:** `POST`

### Input

| **Argument Name**                       | **Type** | **Required** | **Description**                                                                           |
| --------------------------------------- | -------- | ------------ | ----------------------------------------------------------------------------------------- |
| `path_parameters.organization_id`       | string   | Required     | Parameters for the Bulk Create Policy Rules action                                        |
| `path_parameters.policy_id`             | string   | Required     | Parameters for the Bulk Create Policy Rules action                                        |
| `policy_rules`                          | array    | Optional     | The list of policy rules to create.                                                       |
| `policy_rules.is_enabled`               | boolean  | Optional     | Whether this policy rule is enabled.                                                      |
| `policy_rules.rule_definition_id`       | string   | Required     | The unique identifier for the rule definition.                                            |
| `policy_rules.scope`                    | object   | Optional     | Parameter for Bulk Create Policy Rules                                                    |
| `policy_rules.scope.condition`          | object   | Optional     | The condition for this policy rule.                                                       |
| `policy_rules.scope.condition.operator` | string   | Optional     | The operator for this condition.                                                          |
| `policy_rules.scope.condition.type`     | string   | Optional     | The type of the condition.                                                                |
| `policy_rules.scope.condition.value`    | array    | Optional     | The value for this condition.                                                             |
| `policy_rules.severity`                 | string   | Optional     | The severity override for this policy rule. Defaults to the policy severity when omitted. |

### Input Example

`{"json_body":{"policy_rules":[{"is_enabled":true,"rule_definition_id":"urd-dd706bbdc8b247c1","scope":{"condition":{"operator":"equals","type":"cloud_account_ou_rule","value":["org_JmHt7ILvHZRc75u2"]}},"severity":"low"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","policy_id":"pol-7667f45094e64494"}}`

### Output

| **Parameter**                                   | **Type** | **Description**                                       |
| ----------------------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                                   | number   | The HTTP status code returned by the API.             |
| `reason`                                        | string   | The HTTP reason phrase returned with the status code. |
| `items`                                         | array    | The policy rules that were created.                   |
| `items.create_time`                             | string   | The time the policy rule was created.                 |
| `items.creator_id`                              | string   | The identity that created this policy rule.           |
| `items.default_values`                          | object   | The default values of this policy rule.               |
| `items.default_values.is_enabled`               | boolean  | Whether this policy rule is enabled by default.       |
| `items.default_values.is_suspended`             | boolean  | Whether this policy rule is suspended by default.     |
| `items.default_values.scope`                    | object   | The default scope of this policy rule.                |
| `items.default_values.scope.condition`          | object   | The condition for this policy rule.                   |
| `items.default_values.scope.condition.operator` | string   | The operator for this condition.                      |
| `items.default_values.scope.condition.type`     | string   | The type of the condition.                            |
| `items.default_values.scope.condition.value`    | array    | The value for this condition.                         |
| `items.default_values.severity`                 | string   | The default severity of this policy rule.             |
| `items.is_enabled`                              | boolean  | Whether this policy rule is enabled.                  |
| `items.is_suspended`                            | boolean  | Whether this policy rule is suspended.                |
| `items.last_modifier_id`                        | string   | The identity that last modified this policy rule.     |
| `items.policy_id`                               | string   | The unique identifier of the policy.                  |
| `items.policy_rule_id`                          | string   | The unique identifier of the policy rule.             |
| `items.rule_definition_id`                      | string   | The unique identifier of the rule definition.         |
| `items.rule_definition_name`                    | string   | The name of the attached rule definition.             |
| `items.scope`                                   | object   | The scope for this policy rule.                       |
| `items.scope.condition`                         | object   | The condition for this policy rule.                   |
| `items.scope.condition.operator`                | string   | The operator for this condition.                      |
| `items.scope.condition.type`                    | string   | The type of the condition.                            |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Bulk Create Rule Definitions

Create multiple rule definitions in Upwind Security by providing an organization ID and a list of rule definitions.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/rule-definitions/bulk`
- **Method:** `POST`

### Input

| **Argument Name**                                 | **Type** | **Required** | **Description**                                                                                                                                                                                                                                                                                       |
| ------------------------------------------------- | -------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path_parameters.organization_id`                 | string   | Required     | The unique identifier for the Upwind organization.                                                                                                                                                                                                                                                    |
| `rule_definitions`                                | array    | Optional     | The list of rule definitions to create. Must contain between 1 and 100 items.                                                                                                                                                                                                                         |
| `rule_definitions.engine`                         | string   | Required     | The detection engine of this rule definition.                                                                                                                                                                                                                                                         |
| `rule_definitions.metadata`                       | object   | Required     | The display and MITRE ATT\&CK metadata of this rule definition.                                                                                                                                                                                                                                       |
| `rule_definitions.metadata.detection_description` | string   | Required     | The detection description of this rule definition.                                                                                                                                                                                                                                                    |
| `rule_definitions.metadata.detection_title`       | string   | Required     | The detection title of this rule definition.                                                                                                                                                                                                                                                          |
| `rule_definitions.metadata.mitre_tactic_code`     | string   | Optional     | The MITRE ATT\&CK tactic code associated with this rule definition.                                                                                                                                                                                                                                   |
| `rule_definitions.metadata.mitre_tactic_name`     | string   | Optional     | The name of the MITRE ATT\&CK tactic associated with this rule definition.                                                                                                                                                                                                                            |
| `rule_definitions.metadata.mitre_technique_code`  | string   | Optional     | The MITRE ATT\&CK technique code associated with this rule definition.                                                                                                                                                                                                                                |
| `rule_definitions.metadata.mitre_technique_name`  | string   | Optional     | The name of the MITRE ATT\&CK technique associated with this rule definition.                                                                                                                                                                                                                         |
| `rule_definitions.name`                           | string   | Required     | The name of this rule definition.                                                                                                                                                                                                                                                                     |
| `rule_definitions.rule_expression`                | string   | Required     | The rule expression body of this rule definition. Must be a valid Rego expression and must include a package declaration as the first line, following the pattern: package policy.custom.\<threat\_category> (e.g. package policy.custom.cloud\_trail\_logs for threat\_category cloud\_trail\_logs). |
| `rule_definitions.threat_category`                | string   | Required     | The threat category of this rule definition.                                                                                                                                                                                                                                                          |

### Input Example

`{"json_body":{"rule_definitions":[{"engine":"rego","metadata":{"detection_description":"Detects API calls made without proper authorization","detection_title":"Unauthorized API Call Detection","mitre_tactic_code":"TA0001","mitre_tactic_name":"Initial Access","mitre_technique_code":"T1078","mitre_technique_name":"Valid Accounts"},"name":"Unauthorized API Call Detection","rule_expression":"string","threat_category":"k8s_audit_logs"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                                               |
| -------------------------------------- | -------- | ----------------------------------------------------------------------------- |
| `status_code`                          | number   | The HTTP status code returned by the API.                                     |
| `reason`                               | string   | The HTTP reason phrase returned with the status code.                         |
| `items`                                | array    | The rule definitions that were created.                                       |
| `items.create_time`                    | string   | The time the rule definition was created.                                     |
| `items.creator_id`                     | string   | The identity that created this rule definition.                               |
| `items.engine`                         | string   | The detection engine of this rule definition.                                 |
| `items.last_modifier_id`               | string   | The identity that last modified this rule definition.                         |
| `items.metadata`                       | object   | The display and MITRE ATT\&CK metadata of this rule definition.               |
| `items.metadata.detection_description` | string   | The detection description of this rule definition.                            |
| `items.metadata.detection_title`       | string   | The detection title of this rule definition.                                  |
| `items.metadata.mitre_tactic_code`     | string   | The MITRE ATT\&CK tactic code associated with this rule definition.           |
| `items.metadata.mitre_tactic_name`     | string   | The name of the MITRE ATT\&CK tactic associated with this rule definition.    |
| `items.metadata.mitre_technique_code`  | string   | The MITRE ATT\&CK technique code associated with this rule definition.        |
| `items.metadata.mitre_technique_name`  | string   | The name of the MITRE ATT\&CK technique associated with this rule definition. |
| `items.name`                           | string   | The name of this rule definition.                                             |
| `items.rule_definition_id`             | string   | The unique identifier of the rule definition.                                 |
| `items.rule_expression`                | string   | The rule expression body of this rule definition.                             |
| `items.threat_category`                | string   | The threat category of this rule definition.                                  |
| `items.update_time`                    | string   | The time the rule definition was last updated.                                |

### Output Example

`{"status_code":201,"response_headers":{"Date":"Mon, 02 Nov 2026 10:12:13 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"4288127298b389e95192542946b5d530","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Bulk Delete Malware Indicators

Remove multiple malware file hash indicators by specifying their hash values and types for a given organization in Upwind Security.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/malware/bulk`
- **Method:** `DELETE`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                 |
| --------------------------------- | -------- | ------------ | --------------------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.              |
| `items`                           | array    | Optional     | The hash overrides to delete, identified by hash and hash type. |
| `items.hash`                      | string   | Required     | The file hash this override applies to.                         |
| `items.hash_type`                 | string   | Required     | The algorithm used to compute the hash.                         |

### Input Example

`{"json_body":{"items":[{"hash":"1234567890","hash_type":"SHA1"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**   | **Type** | **Description**                                       |
| --------------- | -------- | ----------------------------------------------------- |
| `status_code`   | number   | The HTTP status code returned by the API.             |
| `reason`        | string   | The HTTP reason phrase returned with the status code. |
| `response_text` | string   | The response body returned by the API.                |

### Output Example

`{"status_code":204,"response_headers":{},"reason":"No Content","response_text":""}`

## Bulk Delete Policies

Remove multiple policies and their associated rule attachments from Upwind Security using organization ID and a list of policy IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/bulk`
- **Method:** `DELETE`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                    |
| --------------------------------- | -------- | ------------ | ---------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The ID of the organization.        |
| `policy_ids`                      | array    | Optional     | The IDs of the policies to delete. |

### Input Example

`{"json_body":{"policy_ids":["up-d88baf27c72d47c3"]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**   | **Type** | **Description**                                       |
| --------------- | -------- | ----------------------------------------------------- |
| `status_code`   | number   | The HTTP status code returned by the API.             |
| `reason`        | string   | The HTTP reason phrase returned with the status code. |
| `response_text` | string   | The response body returned by the API.                |

### Output Example

`{"status_code":204,"response_headers":{"Date":"Mon, 02 Nov 2026 10:12:13 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"4288127298b389e95192542946b5d530","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Bulk Delete Policy Rules

Detach multiple rule definitions from a specified policy in Upwind Security using organization ID, policy ID, and a list of policy rule IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/{{policy_id}}/rules/bulk`
- **Method:** `DELETE`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.policy_id`       | string   | Required     | The unique identifier for the policy.              |
| `policy_rule_ids`                 | array    | Optional     | The list of policy rule IDs to delete.             |

### Input Example

`{"json_body":{"policy_rule_ids":["polr-7667f45094e64494"]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","policy_id":"pol-7667f45094e64494"}}`

### Output

| **Parameter**   | **Type** | **Description**                                       |
| --------------- | -------- | ----------------------------------------------------- |
| `status_code`   | number   | The HTTP status code returned by the API.             |
| `reason`        | string   | The HTTP reason phrase returned with the status code. |
| `response_text` | string   | The response body returned by the API.                |

### Output Example

`{"status_code":204,"response_headers":{},"reason":"No Content","response_text":""}`

## Bulk Delete Rule Definitions

Remove multiple rule definitions and their associated policy attachments from Upwind Security using specified organization ID and rule definition IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/rule-definitions/bulk`
- **Method:** `DELETE`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                            |
| --------------------------------- | -------- | ------------ | ---------------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.         |
| `rule_definition_ids`             | array    | Optional     | The unique identifiers for the rule definitions to delete. |

### Input Example

`{"json_body":{"rule_definition_ids":["urd-dd706bbdc8b247c1"]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**   | **Type** | **Description**                                       |
| --------------- | -------- | ----------------------------------------------------- |
| `status_code`   | number   | The HTTP status code returned by the API.             |
| `reason`        | string   | The HTTP reason phrase returned with the status code. |
| `response_text` | string   | The response body returned by the API.                |

### Output Example

`{"status_code":204,"response_headers":{"Date":"Mon, 02 Nov 2026 10:12:13 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"4288127298b389e95192542946b5d530","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Bulk Delete Stories

Permanently remove multiple stories from Upwind Security using organization ID and a list of items; this operation cannot be undone.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/stories/bulk`
- **Method:** `DELETE`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `items`                           | array    | Optional     | Parameter for Bulk Delete Stories                  |
| `items.detections_action`         | string   | Required     | The action to take for the detections.             |
| `items.id`                        | string   | Required     | The unique identifier for the story.               |

### Input Example

`{"json_body":{"items":[{"detections_action":"ARCHIVE","id":"sto-7667f45094e64494"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**   | **Type** | **Description**                                       |
| --------------- | -------- | ----------------------------------------------------- |
| `status_code`   | number   | The HTTP status code returned by the API.             |
| `reason`        | string   | The HTTP reason phrase returned with the status code. |
| `response_text` | string   | The response body returned by the API.                |

### Output Example

`{"status_code":204,"response_headers":{},"reason":"No Content","response_text":""}`

## Bulk Edit Policies

Update multiple policies in Upwind Security; if any policy is not found or fails validation, no changes are applied to any policy.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/bulk`
- **Method:** `PATCH`

### Input

| **Argument Name**                            | **Type** | **Required** | **Description**                                                                                     |
| -------------------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------- |
| `path_parameters.organization_id`            | string   | Required     | The ID of the organization to update the policies for.                                              |
| `policies`                                   | array    | Optional     | The list of policies to edit. If any item is not found or fails validation, no updates are applied. |
| `policies.default_severity`                  | string   | Optional     | The default severity of the policy.                                                                 |
| `policies.id`                                | string   | Required     | The ID of the policy to update.                                                                     |
| `policies.is_enabled`                        | boolean  | Optional     | Whether the policy is enabled.                                                                      |
| `policies.metadata`                          | object   | Optional     | The new display detection metadata of this policy. Omit to keep the existing value.                 |
| `policies.metadata.detection_description`    | string   | Optional     | The new detection description of this policy.                                                       |
| `policies.metadata.detection_title`          | string   | Optional     | The new detection title of this policy.                                                             |
| `policies.name`                              | string   | Optional     | The new name of this policy. Omit to keep the existing value.                                       |
| `policies.resource_scope`                    | object   | Optional     | Parameter for Bulk Edit Policies                                                                    |
| `policies.resource_scope.condition`          | object   | Required     | Parameter for Bulk Edit Policies                                                                    |
| `policies.resource_scope.condition.operator` | string   | Optional     | The operator of the condition.                                                                      |
| `policies.resource_scope.condition.type`     | string   | Optional     | The type of the condition.                                                                          |
| `policies.resource_scope.condition.value`    | array    | Optional     | The value of the condition.                                                                         |

### Input Example

`{"json_body":{"policies":[{"default_severity":"low","id":"cp-20c87bfdb4f6475e","is_enabled":true,"metadata":{"detection_description":"Surfaces role or permission changes that grant elevated access.","detection_title":"Privilege Escalation Attempt"},"name":"Cloudtrail Management Exposure Violations Testing Edited","resource_scope":{"condition":{"operator":"equals","type":"cloud_account_ou_rule","value":["cloud_logs"]}}}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                             | **Type** | **Description**                                                    |
| ----------------------------------------- | -------- | ------------------------------------------------------------------ |
| `status_code`                             | number   | The HTTP status code returned by the API.                          |
| `reason`                                  | string   | The HTTP reason phrase returned with the status code.              |
| `items`                                   | array    | The policies that were updated.                                    |
| `items.policy_id`                         | string   | The unique identifier of the policy.                               |
| `items.name`                              | string   | The name of this policy.                                           |
| `items.source_type`                       | string   | The telemetry source type of this policy.                          |
| `items.severity`                          | string   | The severity of this policy.                                       |
| `items.resource_scope`                    | object   | The resource scope of this policy.                                 |
| `items.resource_scope.condition`          | object   | The condition that defines which resources this policy applies to. |
| `items.resource_scope.condition.type`     | string   | The type of the condition.                                         |
| `items.resource_scope.condition.operator` | string   | The match operator.                                                |
| `items.resource_scope.condition.value`    | array    | The values to match against.                                       |
| `items.metadata`                          | object   | The display metadata of this policy.                               |
| `items.metadata.detection_title`          | string   | The detection title of this policy.                                |
| `items.metadata.detection_description`    | string   | The detection description of this policy.                          |
| `items.is_enabled`                        | boolean  | Whether this policy is enabled.                                    |
| `items.creator_id`                        | string   | The identity that created this policy.                             |
| `items.last_modifier_id`                  | string   | The identity that last modified this policy.                       |
| `items.create_time`                       | string   | The time the policy was created.                                   |
| `items.update_time`                       | string   | The time the policy was last updated.                              |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Thu, 29 Oct 2026 02:42:30 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"2b7f8f8fa0bc7fbb6222989be54f544a","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Bulk Edit Policy Rules

Update multiple policy rules within a specified organization and policy in Upwind Security by providing the required policy rule details.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/{{policy_id}}/rules/bulk`
- **Method:** `PATCH`

### Input

| **Argument Name**                       | **Type** | **Required** | **Description**                                                                           |
| --------------------------------------- | -------- | ------------ | ----------------------------------------------------------------------------------------- |
| `path_parameters.organization_id`       | string   | Required     | The unique identifier for the Upwind organization.                                        |
| `path_parameters.policy_id`             | string   | Required     | The unique identifier for the policy.                                                     |
| `policy_rules`                          | array    | Optional     | The list of policy rules to update.                                                       |
| `policy_rules.id`                       | string   | Required     | The unique identifier for the policy rule.                                                |
| `policy_rules.is_enabled`               | boolean  | Optional     | Whether this policy rule is enabled.                                                      |
| `policy_rules.scope`                    | object   | Optional     | The scope for this policy rule.                                                           |
| `policy_rules.scope.condition`          | object   | Optional     | The condition for this policy rule.                                                       |
| `policy_rules.scope.condition.operator` | string   | Optional     | The operator for this condition.                                                          |
| `policy_rules.scope.condition.type`     | string   | Optional     | The type of the condition.                                                                |
| `policy_rules.scope.condition.value`    | array    | Optional     | The value for this condition.                                                             |
| `policy_rules.severity`                 | string   | Optional     | The severity override for this policy rule. Defaults to the policy severity when omitted. |

### Input Example

`{"json_body":{"policy_rules":[{"id":"polr-7667f45094e64494","is_enabled":true,"scope":{"condition":{"operator":"equals","type":"cloud_account_ou_rule","value":["org_JmHt7ILvHZRc75u2"]}},"severity":"low"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","policy_id":"pol-7667f45094e64494"}}`

### Output

| **Parameter**                                   | **Type** | **Description**                                       |
| ----------------------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                                   | number   | The HTTP status code returned by the API.             |
| `reason`                                        | string   | The HTTP reason phrase returned with the status code. |
| `items`                                         | array    | The policy rules that were updated.                   |
| `items.create_time`                             | string   | The time the policy rule was created.                 |
| `items.creator_id`                              | string   | The identity that created this policy rule.           |
| `items.default_values`                          | object   | The default values of this policy rule.               |
| `items.default_values.is_enabled`               | boolean  | Whether this policy rule is enabled by default.       |
| `items.default_values.is_suspended`             | boolean  | Whether this policy rule is suspended by default.     |
| `items.default_values.scope`                    | object   | The default scope of this policy rule.                |
| `items.default_values.scope.condition`          | object   | The condition for this policy rule.                   |
| `items.default_values.scope.condition.operator` | string   | The operator for this condition.                      |
| `items.default_values.scope.condition.type`     | string   | The type of the condition.                            |
| `items.default_values.scope.condition.value`    | array    | The value for this condition.                         |
| `items.default_values.severity`                 | string   | The default severity of this policy rule.             |
| `items.is_enabled`                              | boolean  | Whether this policy rule is enabled.                  |
| `items.is_suspended`                            | boolean  | Whether this policy rule is suspended.                |
| `items.last_modifier_id`                        | string   | The identity that last modified this policy rule.     |
| `items.policy_id`                               | string   | The unique identifier of the policy.                  |
| `items.policy_rule_id`                          | string   | The unique identifier of the policy rule.             |
| `items.rule_definition_id`                      | string   | The unique identifier of the rule definition.         |
| `items.rule_definition_name`                    | string   | The name of the attached rule definition.             |
| `items.scope`                                   | object   | The scope for this policy rule.                       |
| `items.scope.condition`                         | object   | The condition for this policy rule.                   |
| `items.scope.condition.operator`                | string   | The operator for this condition.                      |
| `items.scope.condition.type`                    | string   | The type of the condition.                            |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Bulk Edit Rule Definitions

Update multiple rule definitions in Upwind Security by providing the organization ID and a list of rule definitions to modify.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/rule-definitions/bulk`
- **Method:** `PATCH`

### Input

| **Argument Name**                                 | **Type** | **Required** | **Description**                                                                                                                                   |
| ------------------------------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `path_parameters.organization_id`                 | string   | Required     | The unique identifier for the Upwind organization.                                                                                                |
| `rule_definitions`                                | array    | Optional     | The list of rule definitions to edit. If any item is not found or fails validation, no updates are applied. Must contain between 1 and 100 items. |
| `rule_definitions.id`                             | string   | Required     | The unique identifier of the rule definition to edit.                                                                                             |
| `rule_definitions.metadata`                       | object   | Optional     | The new display and MITRE ATT\&CK metadata.                                                                                                       |
| `rule_definitions.metadata.detection_description` | string   | Optional     | The new detection description of this rule definition.                                                                                            |
| `rule_definitions.metadata.detection_title`       | string   | Optional     | The new detection title of this rule definition.                                                                                                  |
| `rule_definitions.metadata.mitre_tactic_code`     | string   | Optional     | The new MITRE ATT\&CK tactic code associated with this rule definition.                                                                           |
| `rule_definitions.metadata.mitre_tactic_name`     | string   | Optional     | The new name of the MITRE ATT\&CK tactic associated with this rule definition.                                                                    |
| `rule_definitions.metadata.mitre_technique_code`  | string   | Optional     | The new MITRE ATT\&CK technique code associated with this rule definition.                                                                        |
| `rule_definitions.metadata.mitre_technique_name`  | string   | Optional     | The new name of the MITRE ATT\&CK technique associated with this rule definition.                                                                 |
| `rule_definitions.name`                           | string   | Optional     | The new name of this rule definition.                                                                                                             |
| `rule_definitions.rule_expression`                | string   | Optional     | The new rule expression body of this rule definition. An invalid expression is rejected.                                                          |

### Input Example

`{"json_body":{"rule_definitions":[{"id":"urd-dd706bbdc8b247c1","metadata":{"detection_description":"Detects API calls made without proper authorization","detection_title":"Unauthorized API Call Detection","mitre_tactic_code":"TA0001","mitre_tactic_name":"Initial Access","mitre_technique_code":"T1078","mitre_technique_name":"Valid Accounts"},"name":"Unauthorized API Call Detection","rule_expression":"package policy.upwind.cloud_trail_logs"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                                               |
| -------------------------------------- | -------- | ----------------------------------------------------------------------------- |
| `status_code`                          | number   | The HTTP status code returned by the API.                                     |
| `reason`                               | string   | The HTTP reason phrase returned with the status code.                         |
| `items`                                | array    | The rule definitions that were updated.                                       |
| `items.create_time`                    | string   | The time the rule definition was created.                                     |
| `items.creator_id`                     | string   | The identity that created this rule definition.                               |
| `items.engine`                         | string   | The detection engine of this rule definition.                                 |
| `items.last_modifier_id`               | string   | The identity that last modified this rule definition.                         |
| `items.metadata`                       | object   | The display and MITRE ATT\&CK metadata of this rule definition.               |
| `items.metadata.detection_description` | string   | The detection description of this rule definition.                            |
| `items.metadata.detection_title`       | string   | The detection title of this rule definition.                                  |
| `items.metadata.mitre_tactic_code`     | string   | The MITRE ATT\&CK tactic code associated with this rule definition.           |
| `items.metadata.mitre_tactic_name`     | string   | The name of the MITRE ATT\&CK tactic associated with this rule definition.    |
| `items.metadata.mitre_technique_code`  | string   | The MITRE ATT\&CK technique code associated with this rule definition.        |
| `items.metadata.mitre_technique_name`  | string   | The name of the MITRE ATT\&CK technique associated with this rule definition. |
| `items.name`                           | string   | The name of this rule definition.                                             |
| `items.rule_definition_id`             | string   | The unique identifier of the rule definition.                                 |
| `items.rule_expression`                | string   | The rule expression body of this rule definition.                             |
| `items.threat_category`                | string   | The threat category of this rule definition.                                  |
| `items.update_time`                    | string   | The time the rule definition was last updated.                                |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Bulk Update Stories

Update the status of multiple stories in Upwind Security by specifying the organization ID and a list of story items.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/stories/bulk`
- **Method:** `PATCH`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `items`                           | array    | Optional     | Parameter for Bulk Update Stories                  |
| `items.detections_action`         | string   | Optional     | The action to take for the detections.             |
| `items.id`                        | string   | Required     | The unique identifier for the story.               |
| `items.status`                    | string   | Required     | The status to set for the story.                   |
| `items.status_reason`             | string   | Optional     | The reason for the status.                         |

### Input Example

`{"json_body":{"items":[{"detections_action":"ARCHIVE","id":"sto-7667f45094e64494","status":"OPEN","status_reason":"Accepted Risk"}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**         | **Type** | **Description**                                           |
| --------------------- | -------- | --------------------------------------------------------- |
| `status_code`         | number   | The HTTP status code returned by the API.                 |
| `reason`              | string   | The HTTP reason phrase returned with the status code.     |
| `items`               | array    | The stories that were updated.                            |
| `items.create_time`   | string   | The time the story was created.                           |
| `items.description`   | string   | The description of this story.                            |
| `items.detection_ids` | array    | The identifiers of the detections included in this story. |
| `items.id`            | string   | The unique identifier of this story.                      |
| `items.severity`      | string   | The severity of this story.                               |
| `items.status`        | string   | The status of this story.                                 |
| `items.status_reason` | string   | The reason for the current status.                        |
| `items.title`         | string   | The title of this story.                                  |
| `items.update_time`   | string   | The time the story was last updated.                      |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Create an Indicator Datasets

Create a new indicator dataset in Upwind Security by uploading a JSON file, including STIX 2.1 bundles, along with associated metadata.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/datasets`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `files`                           | object   | Required     | Parameter for Create an Indicator Datasets         |
| `files.file`                      | string   | Optional     | Parameter for Create an Indicator Datasets         |
| `files.file_name`                 | string   | Optional     | Name of the resource                               |
| `metadata`                        | object   | Optional     | The metadata of the indicator dataset.             |
| `metadata.description`            | string   | Optional     | The description of the indicator dataset.          |
| `metadata.name`                   | string   | Required     | The name of the indicator dataset.                 |
| `metadata.tags`                   | object   | Optional     | The tags of the indicator dataset.                 |

### Input Example

`{"json_body":{"metadata":{"description":"test","name":"test","tags":{}}},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"},"files":{"file":"file","file_name":"test.csv"}}`

### Output

| **Parameter**                        | **Type** | **Description**                                         |
| ------------------------------------ | -------- | ------------------------------------------------------- |
| `status_code`                        | number   | The HTTP status code returned by the API.               |
| `reason`                             | string   | The HTTP reason phrase returned with the status code.   |
| `items`                              | array    | The indicator dataset that was created.                 |
| `items.attached_rule_definition_ids` | array    | The rule definitions this dataset is attached to.       |
| `items.checksum`                     | string   | The checksum of the dataset content.                    |
| `items.content`                      | string   | The content of the indicator dataset.                   |
| `items.create_time`                  | string   | The time the indicator dataset was created.             |
| `items.creator_id`                   | string   | The identity that created this indicator dataset.       |
| `items.description`                  | string   | The description of the indicator dataset.               |
| `items.file_format`                  | string   | The file format of the dataset content.                 |
| `items.last_modifier_id`             | string   | The identity that last modified this indicator dataset. |
| `items.name`                         | string   | The name of the indicator dataset.                      |
| `items.size_bytes`                   | number   | The size of the dataset content, in bytes.              |
| `items.tags`                         | object   | The tags of the indicator dataset.                      |
| `items.tags.source`                  | string   | The source tag for this dataset.                        |
| `items.update_time`                  | string   | The time the indicator dataset was last updated.        |
| `items.version`                      | number   | The version of the indicator dataset.                   |

### Output Example

`{"status_code":201,"response_headers":{"Date":"Mon, 02 Nov 2026 23:33:27 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"7cc555e73549cd006f9ea1fb5ca8af2e","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Delete an Indicator Dataset

Delete an indicator dataset and all its versions from Upwind Security using the specified organization ID and dataset name.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/datasets/{{name}}`
- **Method:** `DELETE`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.name`            | string   | Required     | The unique name of the indicator dataset.          |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","name":"test"}}`

### Output

| **Parameter**   | **Type** | **Description**                                       |
| --------------- | -------- | ----------------------------------------------------- |
| `status_code`   | number   | The HTTP status code returned by the API.             |
| `reason`        | string   | The HTTP reason phrase returned with the status code. |
| `response_text` | string   | The response body returned by the API.                |

### Output Example

`{"status_code":204,"response_headers":{},"reason":"No Content","response_text":""}`

## Download a Threat Agent Skill

Download a specified threat agent skill as a ZIP archive using organization ID and skill name.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/skills/{{skill_name}}`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.skill_name`      | string   | Required     | The name of the skill to download.                 |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","skill_name":"threat_agent_skill.json"}}`

### Output

| **Parameter**    | **Type** | **Description**                                       |
| ---------------- | -------- | ----------------------------------------------------- |
| `status_code`    | number   | The HTTP status code returned by the API.             |
| `reason`         | string   | The HTTP reason phrase returned with the status code. |
| `file`           | object   | The downloaded skill archive.                         |
| `file.filename`  | string   | The name of the downloaded file.                      |
| `file.file_data` | string   | The contents of the downloaded file.                  |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","file":{"filename":"threat_agent_skill.json","file_data":"test"}}`

## Get a Findings

Retrieve detailed information about a specific configuration finding using the organization and finding IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/configurations/findings/{{finding_id}}`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.finding_id`      | string   | Required     | The unique identifier for the Finding.             |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","finding_id":"finding_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                                        | **Type** | **Description**                                              |
| ---------------------------------------------------- | -------- | ------------------------------------------------------------ |
| `status_code`                                        | number   | The HTTP status code returned by the API.                    |
| `reason`                                             | string   | The HTTP reason phrase returned with the status code.        |
| `items`                                              | array    | The finding that was retrieved.                              |
| `items.evaluation_time`                              | string   | The time this finding was evaluated.                         |
| `items.first_seen_time`                              | string   | The time this finding was first seen.                        |
| `items.framework`                                    | object   | The compliance framework associated with this finding.       |
| `items.framework.cloud_provider_name`                | string   | The cloud provider this framework applies to.                |
| `items.framework.compliance_status`                  | object   | The compliance status of this framework.                     |
| `items.framework.compliance_status.compliance_score` | number   | The compliance score for this framework.                     |
| `items.framework.create_time`                        | string   | The time the framework was created.                          |
| `items.framework.description`                        | string   | The description of this framework.                           |
| `items.framework.id`                                 | string   | The unique identifier of this framework.                     |
| `items.framework.last_scan_time`                     | string   | The time this framework was last scanned.                    |
| `items.framework.revision`                           | string   | The revision of this framework.                              |
| `items.framework.rollout_state`                      | string   | The rollout state of this framework.                         |
| `items.framework.status`                             | string   | The status of this framework.                                |
| `items.framework.title`                              | string   | The title of this framework.                                 |
| `items.framework.type`                               | string   | The type of this framework.                                  |
| `items.framework.update_time`                        | string   | The time the framework was last updated.                     |
| `items.framework.version`                            | string   | The version of this framework.                               |
| `items.id`                                           | string   | The unique identifier of this finding.                       |
| `items.resource`                                     | object   | The cloud resource this finding applies to.                  |
| `items.resource.arn`                                 | string   | The Amazon Resource Name of this resource.                   |
| `items.resource.cloud_account_id`                    | string   | The identifier of the cloud account that owns this resource. |
| `items.resource.cloud_account_name`                  | string   | The name of the cloud account that owns this resource.       |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Get a Policy

Get detailed information about a specific policy in Upwind Security using the organization and policy IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/{{policy_id}}`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.policy_id`       | string   | Required     | The unique identifier of the policy.               |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","policy_id":"up-095b4149d0a149dc"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                       |
| -------------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                          | number   | The HTTP status code returned by the API.             |
| `reason`                               | string   | The HTTP reason phrase returned with the status code. |
| `items`                                | array    | The policy that was retrieved.                        |
| `items.policy_id`                      | string   | The unique identifier of the policy.                  |
| `items.name`                           | string   | The name of this policy.                              |
| `items.source_type`                    | string   | The telemetry source type of this policy.             |
| `items.severity`                       | string   | The severity of this policy.                          |
| `items.metadata`                       | object   | The display metadata of this policy.                  |
| `items.metadata.detection_title`       | string   | The detection title of this policy.                   |
| `items.metadata.detection_description` | string   | The detection description of this policy.             |
| `items.is_enabled`                     | boolean  | Whether this policy is enabled.                       |
| `items.creator_id`                     | string   | The identity that created this policy.                |
| `items.last_modifier_id`               | string   | The identity that last modified this policy.          |
| `items.create_time`                    | string   | The time the policy was created.                      |
| `items.update_time`                    | string   | The time the policy was last updated.                 |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Wed, 28 Oct 2026 10:35:24 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"9a213c654844201a63617ab59932f1ef","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Get a Policy Rule

Get detailed information about a specific policy rule in Upwind Security using organization, policy, and rule identifiers.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/{{policy_id}}/rules/{{policy_rule_id}}`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.policy_id`       | string   | Required     | The unique identifier for the policy.              |
| `path_parameters.policy_rule_id`  | string   | Required     | The unique identifier for the policy rule.         |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","policy_id":"pol-7667f45094e64494","policy_rule_id":"polr-7667f45094e64494"}}`

### Output

| **Parameter**                                   | **Type** | **Description**                                       |
| ----------------------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                                   | number   | The HTTP status code returned by the API.             |
| `reason`                                        | string   | The HTTP reason phrase returned with the status code. |
| `items`                                         | array    | The policy rule that was retrieved.                   |
| `items.create_time`                             | string   | The time the policy rule was created.                 |
| `items.creator_id`                              | string   | The identity that created this policy rule.           |
| `items.default_values`                          | object   | The default values of this policy rule.               |
| `items.default_values.is_enabled`               | boolean  | Whether this policy rule is enabled by default.       |
| `items.default_values.is_suspended`             | boolean  | Whether this policy rule is suspended by default.     |
| `items.default_values.scope`                    | object   | The default scope of this policy rule.                |
| `items.default_values.scope.condition`          | object   | The condition for this policy rule.                   |
| `items.default_values.scope.condition.operator` | string   | The operator for this condition.                      |
| `items.default_values.scope.condition.type`     | string   | The type of the condition.                            |
| `items.default_values.scope.condition.value`    | array    | The value for this condition.                         |
| `items.default_values.severity`                 | string   | The default severity of this policy rule.             |
| `items.is_enabled`                              | boolean  | Whether this policy rule is enabled.                  |
| `items.is_suspended`                            | boolean  | Whether this policy rule is suspended.                |
| `items.last_modifier_id`                        | string   | The identity that last modified this policy rule.     |
| `items.policy_id`                               | string   | The unique identifier of the policy.                  |
| `items.policy_rule_id`                          | string   | The unique identifier of the policy rule.             |
| `items.rule_definition_id`                      | string   | The unique identifier of the rule definition.         |
| `items.rule_definition_name`                    | string   | The name of the attached rule definition.             |
| `items.scope`                                   | object   | The scope for this policy rule.                       |
| `items.scope.condition`                         | object   | The condition for this policy rule.                   |
| `items.scope.condition.operator`                | string   | The operator for this condition.                      |
| `items.scope.condition.type`                    | string   | The type of the condition.                            |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Get a Rule Definition

Return detailed information about a specific rule definition in Upwind Security using the organization and rule definition IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/rule-definitions/{{rule_definition_id}}`
- **Method:** `GET`

### Input

| **Argument Name**                    | **Type** | **Required** | **Description**                                            |
| ------------------------------------ | -------- | ------------ | ---------------------------------------------------------- |
| `path_parameters.organization_id`    | string   | Required     | The ID of the organization to get the rule definition for. |
| `path_parameters.rule_definition_id` | string   | Required     | The ID of the rule definition to get.                      |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","rule_definition_id":"urd-dd706bbdc8b247c1"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                                               |
| -------------------------------------- | -------- | ----------------------------------------------------------------------------- |
| `status_code`                          | number   | The HTTP status code returned by the API.                                     |
| `reason`                               | string   | The HTTP reason phrase returned with the status code.                         |
| `items`                                | array    | The rule definition that was retrieved.                                       |
| `items.rule_definition_id`             | string   | The unique identifier of the rule definition.                                 |
| `items.name`                           | string   | The name of this rule definition.                                             |
| `items.engine`                         | string   | The detection engine of this rule definition.                                 |
| `items.threat_category`                | string   | The threat category of this rule definition.                                  |
| `items.rule_expression`                | string   | The rule expression body of this rule definition.                             |
| `items.metadata`                       | object   | The display and MITRE ATT\&CK metadata of this rule definition.               |
| `items.metadata.detection_title`       | string   | The detection title of this rule definition.                                  |
| `items.metadata.detection_description` | string   | The detection description of this rule definition.                            |
| `items.metadata.mitre_tactic_name`     | string   | The name of the MITRE ATT\&CK tactic associated with this rule definition.    |
| `items.metadata.mitre_tactic_code`     | string   | The MITRE ATT\&CK tactic code associated with this rule definition.           |
| `items.metadata.mitre_technique_name`  | string   | The name of the MITRE ATT\&CK technique associated with this rule definition. |
| `items.metadata.mitre_technique_code`  | string   | The MITRE ATT\&CK technique code associated with this rule definition.        |
| `items.creator_id`                     | string   | The identity that created this rule definition.                               |
| `items.last_modifier_id`               | string   | The identity that last modified this rule definition.                         |
| `items.create_time`                    | string   | The time the rule definition was created.                                     |
| `items.update_time`                    | string   | The time the rule definition was last updated.                                |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 10:07:38 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"876c3a7038a6999d636367a231b6d641","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Get a Story

Get comprehensive information about a specific story in Upwind Security using the organization and story IDs.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/stories/{{story_id}}`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.story_id`        | string   | Required     | The unique identifier for the story.               |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","story_id":"sto-7667f45094e64494"}}`

### Output

| **Parameter**         | **Type** | **Description**                                           |
| --------------------- | -------- | --------------------------------------------------------- |
| `status_code`         | number   | The HTTP status code returned by the API.                 |
| `reason`              | string   | The HTTP reason phrase returned with the status code.     |
| `items`               | array    | The story that was retrieved.                             |
| `items.create_time`   | string   | The time the story was created.                           |
| `items.description`   | string   | The description of this story.                            |
| `items.detection_ids` | array    | The identifiers of the detections included in this story. |
| `items.id`            | string   | The unique identifier of this story.                      |
| `items.severity`      | string   | The severity of this story.                               |
| `items.status`        | string   | The status of this story.                                 |
| `items.status_reason` | string   | The reason for the current status.                        |
| `items.title`         | string   | The title of this story.                                  |
| `items.update_time`   | string   | The time the story was last updated.                      |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Get an Indicator Datasets

Return the latest version of a specified indicator dataset, including its Base64-encoded content, using organization ID and dataset name.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/datasets/{{name}}`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.name`            | string   | Required     | The name of the indicator dataset.                 |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","name":"test_indicator_dataset"}}`

### Output

| **Parameter**                        | **Type** | **Description**                                         |
| ------------------------------------ | -------- | ------------------------------------------------------- |
| `status_code`                        | number   | The HTTP status code returned by the API.               |
| `reason`                             | string   | The HTTP reason phrase returned with the status code.   |
| `items`                              | array    | The indicator dataset that was retrieved.               |
| `items.attached_rule_definition_ids` | array    | The rule definitions this dataset is attached to.       |
| `items.checksum`                     | string   | The checksum of the dataset content.                    |
| `items.content`                      | string   | The Base64-encoded content of the indicator dataset.    |
| `items.create_time`                  | string   | The time the indicator dataset was created.             |
| `items.creator_id`                   | string   | The identity that created this indicator dataset.       |
| `items.description`                  | string   | The description of the indicator dataset.               |
| `items.file_format`                  | string   | The file format of the dataset content.                 |
| `items.last_modifier_id`             | string   | The identity that last modified this indicator dataset. |
| `items.name`                         | string   | The name of the indicator dataset.                      |
| `items.size_bytes`                   | number   | The size of the dataset content, in bytes.              |
| `items.tags`                         | object   | The tags of the indicator dataset.                      |
| `items.tags.source`                  | string   | The source tag for this dataset.                        |
| `items.update_time`                  | string   | The time the indicator dataset was last updated.        |
| `items.version`                      | number   | The version of the indicator dataset.                   |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Get policies a rule definition is attach to

Retrieve all policies linked to a specific rule definition, including effective values such as severity, scope, scope type, enabled status, and suspension state.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/rule-definitions/{{rule_definition_id}}/policies`
- **Method:** `GET`

### Input

| **Argument Name**                    | **Type** | **Required** | **Description**                                    |
| ------------------------------------ | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id`    | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.rule_definition_id` | string   | Required     | The unique identifier for the rule definition.     |

### Input Example

`{"path_parameters":{"organization_id":"string","rule_definition_id":"string"}}`

### Output

| **Parameter**                    | **Type** | **Description**                                       |
| -------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                    | number   | The HTTP status code returned by the API.             |
| `reason`                         | string   | The HTTP reason phrase returned with the status code. |
| `items`                          | array    | The policies this rule definition is attached to.     |
| `items.create_time`              | string   | The time the policy rule was created.                 |
| `items.creator_id`               | string   | The identity that created this policy rule.           |
| `items.is_enabled`               | boolean  | Whether this policy rule is enabled.                  |
| `items.is_suspended`             | boolean  | Whether this policy rule is suspended.                |
| `items.last_modifier_id`         | string   | The identity that last modified this policy rule.     |
| `items.policy_id`                | string   | The unique identifier of the policy.                  |
| `items.policy_name`              | string   | The name of the policy.                               |
| `items.scope`                    | object   | The scope for this policy rule.                       |
| `items.scope.condition`          | object   | The condition for this policy rule.                   |
| `items.scope.condition.operator` | string   | The operator for this condition.                      |
| `items.scope.condition.type`     | string   | The type of the condition.                            |
| `items.scope.condition.value`    | array    | The value for this condition.                         |
| `items.scope_type`               | string   | The type of scope applied to this policy rule.        |
| `items.severity`                 | string   | The severity of this policy rule.                     |
| `items.update_time`              | string   | The time the policy rule was last updated.            |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 10:12:13 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"4288127298b389e95192542946b5d530","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## List Stories

Retrieve a list of story objects associated with the specified organization in Upwind Security.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/stories`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `parameters.limit`                | number   | Optional     | The maximum number of stories to return.           |
| `parameters.cursor`               | string   | Optional     | The cursor to use for pagination.                  |
| `parameters.sort`                 | string   | Optional     | The field to sort by.                              |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |

### Input Example

`{"parameters":{"limit":50,"cursor":"cursor-7667f45094e64494","sort":"update_time:asc"},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**         | **Type** | **Description**                                           |
| --------------------- | -------- | --------------------------------------------------------- |
| `status_code`         | number   | The HTTP status code returned by the API.                 |
| `reason`              | string   | The HTTP reason phrase returned with the status code.     |
| `items`               | array    | The stories that were returned.                           |
| `items.create_time`   | string   | The time the story was created.                           |
| `items.detection_ids` | array    | The identifiers of the detections included in this story. |
| `items.id`            | string   | The unique identifier of this story.                      |
| `items.severity`      | string   | The severity of this story.                               |
| `items.status`        | string   | The status of this story.                                 |
| `items.title`         | string   | The title of this story.                                  |
| `items.update_time`   | string   | The time the story was last updated.                      |
| `metadata`            | object   | Pagination details for this result set.                   |
| `metadata.limit`      | number   | The maximum number of items returned.                     |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 13:57:31 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"5a58fc5df39b60c737e8a8f0cfefb3a9","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## List Threat Agent Skills

Retrieve a list of threat agent skill objects, including their names, descriptions, and versions, for a specified organization in Upwind Security.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/skills`
- **Method:** `GET`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |

### Input Example

`{"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**       | **Type** | **Description**                                       |
| ------------------- | -------- | ----------------------------------------------------- |
| `status_code`       | number   | The HTTP status code returned by the API.             |
| `reason`            | string   | The HTTP reason phrase returned with the status code. |
| `items`             | array    | The threat agent skills that were returned.           |
| `items.name`        | string   | The name of the threat agent skill.                   |
| `items.description` | string   | The description of the threat agent skill.            |
| `items.version`     | string   | The version of the threat agent skill.                |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 23:33:27 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"7cc555e73549cd006f9ea1fb5ca8af2e","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Search Findings

Retrieve a list of configuration findings from Upwind Security that match specified search conditions and organization ID.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/configurations/findings/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                   |
| --------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `parameters.limit`                | number   | Optional     | The maximum number of findings to return.                                                                                         |
| `parameters.cursor`               | string   | Optional     | The cursor to use for pagination.                                                                                                 |
| `parameters.sort`                 | string   | Optional     | The field to sort by.                                                                                                             |
| `path_parameters.organization_id` | string   | Required     | Parameters for the Search Findings action                                                                                         |
| `conditions`                      | array    | Optional     | The conditions to search for.                                                                                                     |
| `conditions.field`                | string   | Required     | The field to search for.                                                                                                          |
| `conditions.operator`             | string   | Required     | The operator to use for the filter.                                                                                               |
| `conditions.value`                | array    | Required     | The values to compare against. eq, like, gt, gte, lt and lte take exactly one value, in takes one or more, and exists takes none. |

### Input Example

`{"parameters":{"limit":10,"cursor":"eyJvZmZzZXQiOjIwfQ","sort":"create_time:asc"},"json_body":{"conditions":[{"field":"severity","operator":"eq","value":["high"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                             | **Type** | **Description**                                              |
| ----------------------------------------- | -------- | ------------------------------------------------------------ |
| `status_code`                             | number   | The HTTP status code returned by the API.                    |
| `reason`                                  | string   | The HTTP reason phrase returned with the status code.        |
| `items`                                   | array    | The findings that matched the search.                        |
| `items.evaluation_time`                   | string   | The time this finding was evaluated.                         |
| `items.first_seen_time`                   | string   | The time this finding was first seen.                        |
| `items.framework`                         | object   | The compliance framework associated with this finding.       |
| `items.framework.cloud_provider_name`     | string   | The cloud provider this framework applies to.                |
| `items.framework.description`             | string   | The description of this framework.                           |
| `items.framework.id`                      | string   | The unique identifier of this framework.                     |
| `items.framework.revision`                | string   | The revision of this framework.                              |
| `items.framework.status`                  | string   | The status of this framework.                                |
| `items.framework.title`                   | string   | The title of this framework.                                 |
| `items.framework.version`                 | string   | The version of this framework.                               |
| `items.id`                                | string   | The unique identifier of this finding.                       |
| `items.resource`                          | object   | The cloud resource this finding applies to.                  |
| `items.resource.arn`                      | string   | The Amazon Resource Name of this resource.                   |
| `items.resource.cloud_account_id`         | string   | The identifier of the cloud account that owns this resource. |
| `items.resource.cloud_account_name`       | string   | The name of the cloud account that owns this resource.       |
| `items.resource.cloud_account_tags`       | array    | The tags on the cloud account that owns this resource.       |
| `items.resource.cloud_account_tags.key`   | string   | The tag key.                                                 |
| `items.resource.cloud_account_tags.value` | string   | The tag value.                                               |
| `items.resource.cloud_provider_name`      | string   | The cloud provider that hosts this resource.                 |
| `items.resource.cluster_id`               | string   | The identifier of the cluster this resource belongs to.      |
| `items.resource.id`                       | string   | The unique identifier of this resource.                      |
| `items.resource.name`                     | string   | The name of this resource.                                   |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Tue, 03 Nov 2026 06:05:00 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"047084a05a76eb652808a180baa3fff1","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Search Indicator Datasets

Retrieve a filtered list of indicator dataset objects for a specified organization using defined search criteria.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/datasets/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                   |
| --------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `parameters.limit`                | number   | Optional     | Specifies the maximum number of items to be returned.                                                                             |
| `parameters.cursor`               | string   | Optional     | A cursor for pagination to retrieve the next set of results.                                                                      |
| `parameters.sort`                 | string   | Optional     | Sort results by one or more fields.                                                                                               |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.                                                                                |
| `conditions`                      | array    | Optional     | List of filter conditions to apply to the search                                                                                  |
| `conditions.field`                | string   | Required     | The field name to filter on.                                                                                                      |
| `conditions.operator`             | string   | Required     | The operator to use for the filter.                                                                                               |
| `conditions.value`                | array    | Required     | The values to compare against. eq, like, gt, gte, lt and lte take exactly one value, in takes one or more, and exists takes none. |

### Input Example

`{"parameters":{"limit":10,"cursor":"eyJvZmZzZXQiOjIwfQ","sort":"create_time:asc"},"json_body":{"conditions":[{"field":"file_format","operator":"eq","value":["json"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc775u2"}}`

### Output

| **Parameter**                        | **Type** | **Description**                                         |
| ------------------------------------ | -------- | ------------------------------------------------------- |
| `status_code`                        | number   | The HTTP status code returned by the API.               |
| `reason`                             | string   | The HTTP reason phrase returned with the status code.   |
| `items`                              | array    | The indicator datasets that matched the search.         |
| `items.attached_rule_definition_ids` | array    | The rule definitions this dataset is attached to.       |
| `items.checksum`                     | string   | The checksum of the dataset content.                    |
| `items.content`                      | string   | The content of the indicator dataset.                   |
| `items.create_time`                  | string   | The time the indicator dataset was created.             |
| `items.creator_id`                   | string   | The identity that created this indicator dataset.       |
| `items.description`                  | string   | The description of the indicator dataset.               |
| `items.file_format`                  | string   | The file format of the dataset content.                 |
| `items.last_modifier_id`             | string   | The identity that last modified this indicator dataset. |
| `items.name`                         | string   | The name of the indicator dataset.                      |
| `items.size_bytes`                   | number   | The size of the dataset content, in bytes.              |
| `items.tags`                         | object   | The tags of the indicator dataset.                      |
| `items.tags.source`                  | string   | The source tag for this dataset.                        |
| `items.update_time`                  | string   | The time the indicator dataset was last updated.        |
| `items.version`                      | number   | The version of the indicator dataset.                   |
| `metadata`                           | object   | Pagination details for this result set.                 |
| `metadata.limit`                     | number   | The maximum number of items returned.                   |
| `metadata.next_cursor`               | string   | The cursor for the next page of results.                |
| `metadata.previous_cursor`           | string   | The cursor for the previous page of results.            |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 23:33:27 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"7cc555e73549cd006f9ea1fb5ca8af2e","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Search Malware Indicators

Retrieve a paginated list of malware file hash indicators from Upwind Security that match specified filter conditions, using organization ID and search criteria.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/malware/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                   |
| --------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.                                                                                |
| `conditions`                      | array    | Optional     | List of filter conditions to apply to the search.                                                                                 |
| `conditions.field`                | string   | Required     | The field to filter on.                                                                                                           |
| `conditions.operator`             | string   | Required     | Supported operators are field-specific - eq and in for hash, hash\_type, action; gt and lt for the timestamp field create\_time.  |
| `conditions.value`                | array    | Required     | The values to compare against. eq, like, gt, gte, lt and lte take exactly one value, in takes one or more, and exists takes none. |

### Input Example

`{"json_body":{"conditions":[{"field":"action","operator":"eq","value":["allow"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**              | **Type** | **Description**                                          |
| -------------------------- | -------- | -------------------------------------------------------- |
| `status_code`              | number   | The HTTP status code returned by the API.                |
| `reason`                   | string   | The HTTP reason phrase returned with the status code.    |
| `items`                    | array    | The malware indicators that matched the search.          |
| `items.action`             | string   | The verdict this override forces for the hash.           |
| `items.added_by`           | string   | The identity that created this indicator.                |
| `items.create_time`        | string   | The time the indicator was created.                      |
| `items.hash`               | string   | The file hash this override applies to.                  |
| `items.hash_type`          | string   | The algorithm used to compute the hash.                  |
| `items.reason`             | string   | A free-text explanation for why this override was added. |
| `metadata`                 | object   | Pagination details for this result set.                  |
| `metadata.limit`           | number   | The maximum number of items returned.                    |
| `metadata.next_cursor`     | string   | The cursor for the next page of results.                 |
| `metadata.previous_cursor` | string   | The cursor for the previous page of results.             |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Tue, 03 Nov 2026 00:37:47 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"94099e8ae31d38ada62962f7c54af99f","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Search Policies

Retrieve a filtered list of policy objects for a specified organization in Upwind Security based on defined search conditions.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                                                                       |
| --------------------------------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `parameters.limit`                | number   | Optional     | Specifies the maximum number of items to be returned.                                                                                                                                 |
| `parameters.cursor`               | string   | Optional     | A cursor for pagination to retrieve the next set of results.                                                                                                                          |
| `parameters.sort`                 | string   | Optional     | Sort results by one or more fields. Format - field or field\:asc or field\:desc. Multiple fields -  field1,field2\:desc. Allowed fields - name, severity, create\_time, update\_time. |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.                                                                                                                                    |
| `conditions`                      | array    | Optional     | Parameter for Search Policies                                                                                                                                                         |
| `conditions.field`                | string   | Optional     | The field name to filter on.                                                                                                                                                          |
| `conditions.operator`             | string   | Required     | like is supported for string fields (name, creator\_id, last\_modifier\_id).                                                                                                          |
| `conditions.value`                | array    | Required     | The values to compare against.                                                                                                                                                        |

### Input Example

`{"parameters":{"limit":50,"cursor":"eyJvZmZzZXQiOjIwfQ","sort":"create_time:asc"},"json_body":{"conditions":[{"field":"source_type","operator":"eq","value":["cloud_logs"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                       |
| -------------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                          | number   | The HTTP status code returned by the API.             |
| `reason`                               | string   | The HTTP reason phrase returned with the status code. |
| `items`                                | array    | The policies that matched the search.                 |
| `items.policy_id`                      | string   | The unique identifier of the policy.                  |
| `items.name`                           | string   | The name of this policy.                              |
| `items.source_type`                    | string   | The telemetry source type of this policy.             |
| `items.severity`                       | string   | The severity of this policy.                          |
| `items.metadata`                       | object   | The display metadata of this policy.                  |
| `items.metadata.detection_title`       | string   | The detection title of this policy.                   |
| `items.metadata.detection_description` | string   | The detection description of this policy.             |
| `items.is_enabled`                     | boolean  | Whether this policy is enabled.                       |
| `items.creator_id`                     | string   | The identity that created this policy.                |
| `items.last_modifier_id`               | string   | The identity that last modified this policy.          |
| `items.create_time`                    | string   | The time the policy was created.                      |
| `items.update_time`                    | string   | The time the policy was last updated.                 |
| `metadata`                             | object   | Pagination details for this result set.               |
| `metadata.limit`                       | number   | The maximum number of items returned.                 |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Wed, 28 Oct 2026 10:23:14 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"43ddd719a70df35b959cc5fb9a2ebfc7","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Search Policy Rules

Retrieve a filtered list of policy rule objects for a specified policy in Upwind Security using organization ID, policy ID, and search conditions.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/policies/{{policy_id}}/rules/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                   |
| --------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.                                                                                |
| `path_parameters.policy_id`       | string   | Required     | The unique identifier for the policy.                                                                                             |
| `conditions`                      | array    | Optional     | The conditions to filter the policy rules.                                                                                        |
| `conditions.field`                | string   | Required     | The field to filter the policy rules.                                                                                             |
| `conditions.operator`             | string   | Required     | The operator to filter the policy rules.                                                                                          |
| `conditions.value`                | array    | Required     | The values to compare against. eq, like, gt, gte, lt and lte take exactly one value, in takes one or more, and exists takes none. |

### Input Example

`{"json_body":{"conditions":[{"field":"severity","operator":"eq","value":["high"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","policy_id":"pol-7667f45094e64494"}}`

### Output

| **Parameter**                                   | **Type** | **Description**                                       |
| ----------------------------------------------- | -------- | ----------------------------------------------------- |
| `status_code`                                   | number   | The HTTP status code returned by the API.             |
| `reason`                                        | string   | The HTTP reason phrase returned with the status code. |
| `items`                                         | array    | The policy rules that matched the search.             |
| `items.create_time`                             | string   | The time the policy rule was created.                 |
| `items.creator_id`                              | string   | The identity that created this policy rule.           |
| `items.default_values`                          | object   | The default values of this policy rule.               |
| `items.default_values.is_enabled`               | boolean  | Whether this policy rule is enabled by default.       |
| `items.default_values.is_suspended`             | boolean  | Whether this policy rule is suspended by default.     |
| `items.default_values.scope`                    | object   | The default scope of this policy rule.                |
| `items.default_values.scope.condition`          | object   | The condition for this policy rule.                   |
| `items.default_values.scope.condition.operator` | string   | The operator for this condition.                      |
| `items.default_values.scope.condition.type`     | string   | The type of the condition.                            |
| `items.default_values.scope.condition.value`    | array    | The value for this condition.                         |
| `items.default_values.severity`                 | string   | The default severity of this policy rule.             |
| `items.is_enabled`                              | boolean  | Whether this policy rule is enabled.                  |
| `items.is_suspended`                            | boolean  | Whether this policy rule is suspended.                |
| `items.last_modifier_id`                        | string   | The identity that last modified this policy rule.     |
| `items.policy_id`                               | string   | The unique identifier of the policy.                  |
| `items.policy_rule_id`                          | string   | The unique identifier of the policy rule.             |
| `items.rule_definition_id`                      | string   | The unique identifier of the rule definition.         |
| `items.rule_definition_name`                    | string   | The name of the attached rule definition.             |
| `items.scope`                                   | object   | The scope for this policy rule.                       |
| `items.scope.condition`                         | object   | The condition for this policy rule.                   |
| `items.scope.condition.operator`                | string   | The operator for this condition.                      |
| `items.scope.condition.type`                    | string   | The type of the condition.                            |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}],"metadata":{"limit":20,"next_cursor":"eyJvZmZzZXQiOjIwfQ","previous_cursor":"eyJvZmZzZXQiOjB9"}}}`

## Search Rule Definitions

Retrieve a filtered list of rule definitions for a specified organization based on provided search conditions.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/rule-definitions/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                                                                                                   |
| --------------------------------- | -------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------- |
| `parameters.limit`                | number   | Optional     | The maximum number of rule definitions to return.                                                                                 |
| `parameters.cursor`               | string   | Optional     | The cursor to use for pagination.                                                                                                 |
| `parameters.sort_by`              | string   | Optional     | The field to sort the rule definitions by.                                                                                        |
| `path_parameters.organization_id` | string   | Required     | The ID of the organization to search for rule definitions.                                                                        |
| `conditions`                      | array    | Optional     | List of filter conditions to apply to the search.                                                                                 |
| `conditions.field`                | string   | Required     | The field name to filter on.                                                                                                      |
| `conditions.operator`             | string   | Required     | The operator to use for the filter.                                                                                               |
| `conditions.value`                | array    | Required     | The values to compare against. eq, like, gt, gte, lt and lte take exactly one value, in takes one or more, and exists takes none. |

### Input Example

`{"parameters":{"limit":10,"cursor":"eyJvZmZzZXQiOjIwfQ","sort_by":"create_time:asc"},"json_body":{"conditions":[{"field":"threat_category","operator":"eq","value":["cloud_trail_logs"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**                          | **Type** | **Description**                                                               |
| -------------------------------------- | -------- | ----------------------------------------------------------------------------- |
| `status_code`                          | number   | The HTTP status code returned by the API.                                     |
| `reason`                               | string   | The HTTP reason phrase returned with the status code.                         |
| `items`                                | array    | The rule definitions that matched the search.                                 |
| `items.rule_definition_id`             | string   | The unique identifier of the rule definition.                                 |
| `items.name`                           | string   | The name of this rule definition.                                             |
| `items.engine`                         | string   | The detection engine of this rule definition.                                 |
| `items.threat_category`                | string   | The threat category of this rule definition.                                  |
| `items.metadata`                       | object   | The display and MITRE ATT\&CK metadata of this rule definition.               |
| `items.metadata.detection_title`       | string   | The detection title of this rule definition.                                  |
| `items.metadata.detection_description` | string   | The detection description of this rule definition.                            |
| `items.metadata.mitre_tactic_name`     | string   | The name of the MITRE ATT\&CK tactic associated with this rule definition.    |
| `items.metadata.mitre_tactic_code`     | string   | The MITRE ATT\&CK tactic code associated with this rule definition.           |
| `items.metadata.mitre_technique_name`  | string   | The name of the MITRE ATT\&CK technique associated with this rule definition. |
| `items.metadata.mitre_technique_code`  | string   | The MITRE ATT\&CK technique code associated with this rule definition.        |
| `items.creator_id`                     | string   | The identity that created this rule definition.                               |
| `items.last_modifier_id`               | string   | The identity that last modified this rule definition.                         |
| `items.create_time`                    | string   | The time the rule definition was created.                                     |
| `items.update_time`                    | string   | The time the rule definition was last updated.                                |
| `metadata`                             | object   | Pagination details for this result set.                                       |
| `metadata.limit`                       | number   | The maximum number of items returned.                                         |
| `metadata.next_cursor`                 | string   | The cursor for the next page of results.                                      |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 09:53:56 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"455f4f1ed5665e1c3d4719fdea6ecdbd","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Search Stories

Retrieve a filtered list of story objects for a specified organization based on defined search conditions.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/stories/search`
- **Method:** `POST`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `parameters.limit`                | number   | Optional     | The maximum number of stories to return.           |
| `parameters.cursor`               | string   | Optional     | The cursor to use for pagination.                  |
| `parameters.sort`                 | string   | Optional     | The field to sort by.                              |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `conditions`                      | array    | Optional     | The conditions to search by.                       |
| `conditions.field`                | string   | Required     | The field to search by.                            |
| `conditions.operator`             | string   | Required     | The operator to use for the search.                |
| `conditions.value`                | array    | Required     | The value to search by.                            |

### Input Example

`{"parameters":{"limit":50,"cursor":"eyJvZmZzZXQiOjIwfQ","sort":"update_time:asc"},"json_body":{"conditions":[{"field":"severity","operator":"eq","value":["high"]}]},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2"}}`

### Output

| **Parameter**              | **Type** | **Description**                                           |
| -------------------------- | -------- | --------------------------------------------------------- |
| `status_code`              | number   | The HTTP status code returned by the API.                 |
| `reason`                   | string   | The HTTP reason phrase returned with the status code.     |
| `items`                    | array    | The stories that matched the search.                      |
| `items.create_time`        | string   | The time the story was created.                           |
| `items.detection_ids`      | array    | The identifiers of the detections included in this story. |
| `items.id`                 | string   | The unique identifier of this story.                      |
| `items.severity`           | string   | The severity of this story.                               |
| `items.status`             | string   | The status of this story.                                 |
| `items.title`              | string   | The title of this story.                                  |
| `items.update_time`        | string   | The time the story was last updated.                      |
| `metadata`                 | object   | Pagination details for this result set.                   |
| `metadata.limit`           | number   | The maximum number of items returned.                     |
| `metadata.next_cursor`     | string   | The cursor for the next page of results.                  |
| `metadata.previous_cursor` | string   | The cursor for the previous page of results.              |

### Output Example

`{"status_code":200,"response_headers":{"Date":"Mon, 02 Nov 2026 14:11:18 GMT","Content-Type":"application/json","Transfer-Encoding":"chunked","Connection":"keep-alive","trace-id":"6f5cf63c4c61c6d766d6624e4cbf3892","x-content-type-options":"nosniff","x-xss-protection":"0","cache-control":"no-cache, no-store, max-age=0, must-revalidate","pragma":"no-cache","expires":"0","strict-transport-security":"max-age=31536000 ; includeSubDomains ; preload","x-frame-options":"DENY","vary":"accept-encoding","c...`

## Update an Indicator Dataset

Update the description or tags of an existing indicator dataset in Upwind Security without creating a new version.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/datasets/{{name}}`
- **Method:** `PATCH`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                    |
| --------------------------------- | -------- | ------------ | -------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization. |
| `path_parameters.name`            | string   | Required     | The unique name of the indicator dataset.          |
| `description`                     | string   | Optional     | The description of the indicator dataset.          |
| `tags`                            | object   | Optional     | The tags of the indicator dataset.                 |

### Input Example

`{"json_body":{"description":"Tor exit node IP addresses, refreshed hourly.","tags":{}},"path_parameters":{"organization_id":"string","name":"string"}}`

### Output

| **Parameter**                        | **Type** | **Description**                                         |
| ------------------------------------ | -------- | ------------------------------------------------------- |
| `status_code`                        | number   | The HTTP status code returned by the API.               |
| `reason`                             | string   | The HTTP reason phrase returned with the status code.   |
| `items`                              | array    | The indicator dataset that was updated.                 |
| `items.attached_rule_definition_ids` | array    | The rule definitions this dataset is attached to.       |
| `items.checksum`                     | string   | The checksum of the dataset content.                    |
| `items.content`                      | string   | The content of the indicator dataset.                   |
| `items.create_time`                  | string   | The time the indicator dataset was created.             |
| `items.creator_id`                   | string   | The identity that created this indicator dataset.       |
| `items.description`                  | string   | The description of the indicator dataset.               |
| `items.file_format`                  | string   | The file format of the dataset content.                 |
| `items.last_modifier_id`             | string   | The identity that last modified this indicator dataset. |
| `items.name`                         | string   | The name of the indicator dataset.                      |
| `items.size_bytes`                   | number   | The size of the dataset content, in bytes.              |
| `items.tags`                         | object   | The tags of the indicator dataset.                      |
| `items.tags.source`                  | string   | The source tag for this dataset.                        |
| `items.update_time`                  | string   | The time the indicator dataset was last updated.        |
| `items.version`                      | number   | The version of the indicator dataset.                   |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

## Upload a New Indicator Dataset Version

Upload a file as a new version of an indicator dataset by specifying the organization ID and dataset name, with optional metadata updates.

### Endpoint

- **URL:** `v2/organizations/{{organization_id}}/threats/management/indicators/datasets/{{name}}`
- **Method:** `PUT`

### Input

| **Argument Name**                 | **Type** | **Required** | **Description**                                      |
| --------------------------------- | -------- | ------------ | ---------------------------------------------------- |
| `path_parameters.organization_id` | string   | Required     | The unique identifier for the Upwind organization.   |
| `path_parameters.name`            | string   | Required     | The unique name of the indicator dataset.            |
| `files`                           | object   | Required     | Parameter for Upload a New Indicator Dataset Version |
| `files.file`                      | string   | Required     | Parameter for Upload a New Indicator Dataset Version |
| `files.file_name`                 | string   | Required     | Name of the resource                                 |
| `metadata`                        | object   | Optional     | Response data                                        |
| `metadata.description`            | string   | Optional     | The description of the indicator dataset.            |
| `metadata.tags`                   | object   | Optional     | The tags of the indicator dataset.                   |

### Input Example

`{"json_body":{"metadata":{"description":"test","tags":{}}},"path_parameters":{"organization_id":"org_JmHt7ILvHZRc75u2","name":"test"},"files":{"file":"file","file_name":"test.csv"}}`

### Output

| **Parameter**                        | **Type** | **Description**                                         |
| ------------------------------------ | -------- | ------------------------------------------------------- |
| `status_code`                        | number   | The HTTP status code returned by the API.               |
| `reason`                             | string   | The HTTP reason phrase returned with the status code.   |
| `items`                              | array    | The indicator dataset version that was uploaded.        |
| `items.attached_rule_definition_ids` | array    | The rule definitions this dataset is attached to.       |
| `items.checksum`                     | string   | The checksum of the dataset content.                    |
| `items.content`                      | string   | The content of the indicator dataset.                   |
| `items.create_time`                  | string   | The time the indicator dataset was created.             |
| `items.creator_id`                   | string   | The identity that created this indicator dataset.       |
| `items.description`                  | string   | The description of the indicator dataset.               |
| `items.file_format`                  | string   | The file format of the dataset content.                 |
| `items.last_modifier_id`             | string   | The identity that last modified this indicator dataset. |
| `items.name`                         | string   | The name of the indicator dataset.                      |
| `items.size_bytes`                   | number   | The size of the dataset content, in bytes.              |
| `items.tags`                         | object   | The tags of the indicator dataset.                      |
| `items.tags.source`                  | string   | The source tag for this dataset.                        |
| `items.update_time`                  | string   | The time the indicator dataset was last updated.        |
| `items.version`                      | number   | The version of the indicator dataset.                   |

### Output Example

`{"status_code":200,"response_headers":{},"reason":"OK","json_body":{"items":[{}]}}`

# Response Headers

| **Header**                | **Description**                                            | **Example**                                    |
| ------------------------- | ---------------------------------------------------------- | ---------------------------------------------- |
| cache-control             | Directives for caching mechanisms                          | no-cache, no-store, max-age=0, must-revalidate |
| Connection                | HTTP response header: Connection                           | keep-alive                                     |
| content-encoding          | HTTP response header: content-encoding                     | gzip                                           |
| Content-Type              | The media type of the resource                             | application/json                               |
| Date                      | The date and time at which the message was originated      | Wed, 28 Oct 2026 13:16:28 GMT                  |
| expires                   | The date/time after which the response is considered stale | 0                                              |
| pragma                    | HTTP response header: pragma                               | no-cache                                       |
| strict-transport-security | HTTP response header: strict-transport-security            | max-age=31536000 ; includeSubDomains ; preload |
| trace-id                  | HTTP response header: trace-id                             | 455f4f1ed5665e1c3d4719fdea6ecdbd               |
| Transfer-Encoding         | HTTP response header: Transfer-Encoding                    | chunked                                        |
| vary                      | HTTP response header: vary                                 | accept-encoding                                |
| x-content-type-options    | HTTP response header: x-content-type-options               | nosniff                                        |
| x-frame-options           | HTTP response header: x-frame-options                      | DENY                                           |
| x-xss-protection          | HTTP response header: x-xss-protection                     | 0                                              |
