---
title: "Initiates a transaction to submit multiple requests."
method: POST
path: "/v1/transact"
tags: ["Initiate Transaction"]
---

# Initiates a transaction to submit multiple requests.

`POST /v1/transact`

## Request

- Base URL: `https://api.usa.cloud.watchguard.com/rest/threatsync/management`
- URL: `https://api.usa.cloud.watchguard.com/rest/threatsync/management/v1/transact`
- Auth: API key in header `WatchGuard-API-Key` and HTTP bearer
- TypeScript: <https://skmtc.dev/watchguard/apis/threatsync-management-api/docs/v1/transact/post.ts> (a function with typed inputs; its response is checked against the schema)

Submits multiple requests to ThreatSync Management API endpoints at the same time.

## Request body

- object[]
  - `path` string: Path of the API endpoint.
  - `method` string: HTTP method.
  - `data` object: Request body for this request.

## Response `200`

Successful response.

- union[]: Transaction response.
  - union
    - ActionWithIncidentIdInProgress: Action information.
      - `id` string: ID of an action.
      - `account` string: Account ID.
      - `entityId` string: ID of the entity.
      - `entityType` string: The type of entity.
      - `parameters` object: Parameters required to perform the action. These depend on the specified action.
        - `address` string: The IP address to block.
      - `irreversible` boolean: Indicates whether the action is reversible.
      - `type` string: Identifies whether an action was performed manually or through an automation policy.
      - `responder` string: Indicates whether the action was initiated at the source, initiated manually, or initiated by an automation policy.
      - `creationTime` string: The time the action was created.
      - `command` string: The name of the action performed.
      - `lastUpdateTime` string: Last updated time of the action.
      - `initiatedBy` string: The name of the operator who initiated the action.
      - `incidentId` string: ID of an incident.
      - `errorMessage` string: Describes the reason the action failed.
      - `status` string: Status of the action.
      - `history` object[]
        - `lastUpdateTime` string: Last updated time of the action.
        - `status` string: Status of the action.
    - ActionWithoutIncidentIdInProgress: Action information.
      - `id` string: ID of an action.
      - `account` string: Account ID.
      - `entityId` string: ID of the entity.
      - `entityType` string: The type of entity.
      - `parameters` object: Parameters required to perform the action. These depend on the specified action.
        - `address` string: The IP address to block.
      - `irreversible` boolean: Indicates whether the action is reversible.
      - `type` string: Identifies whether an action was performed manually or through an automation policy.
      - `responder` string: Indicates whether the action was initiated at the source, initiated manually, or initiated by an automation policy.
      - `creationTime` string: The time the action was created.
      - `command` string: The name of the action performed.
      - `lastUpdateTime` string: Last updated time of the action.
      - `initiatedBy` string: The name of the operator who initiated the action.
      - `incidentId` string: ID of an incident.
      - `errorMessage` string: Describes the reason the action failed.
      - `status` string: Status of the action.
      - `history` object[]
        - `lastUpdateTime` string: Last updated time of the action.
        - `status` string: Status of the action.
    - Incident: Incident information.
      - `id` string: ID of the incident.
      - `account` string: Account ID.
      - `category` string: Category of the incident.
      - `type` string: Specific type of incident within an incident category.
      - `timestamp` string: Date and time the incident was created.
      - `threatScore` integer: Threat score of incident.
      - `severity` string: The severity of the incident. Possible values are Low, Medium, High, and Critical.
      - `description` string: A description of the incident.
      - `remediated` boolean: Remediation status of the incident.
      - `entities` object: Details of the entity that the incident belongs to.
        - `8ed6cbce746d4597A6469bbc0c4edce9` object: Entity data.
          - `type` string: Type of entity.
          - `recommendedActions` object[]: List of recommended actions.
            - `command` string: Action to take.
            - `parameters` object: Parameters of an action.
              - …
          - `actionPerformed` object: Information about an action that was performed at the source in response to the event.
            - `command` string: Performed action.
            - `parameters` object: Parameters of an action.
              - …
          - `threatDetails` object: Threat details of an incident.
            - `malware` string: The name of the malware associated with the incident.
            - `file` string: The local path of a file on the computer associated with the incident.
            - `md5` string: The MD5 hash of the file or process associated with the incident.
      - `entityIds` string[]
      - `status` string: Specifies the status of the incident. This can be one of these values: - new - New incidents not yet reviewed. - read - Reviewed incidents or incidents marked as read. - closed - Incidents closed by an automation policy or manually closed.
      - `lastUpdateTime` string: The date and time (in UTC) when the incident status was last changed.
      - `updatedBy` string: The name of the operator that updated the incident status. Or "system" if the update was in response to an automated action.

## Other responses

- `default`: Error response.

---

[API](https://skmtc.dev/watchguard/apis/threatsync-management-api.md) - [All operations](https://skmtc.dev/watchguard/apis/threatsync-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/watchguard/apis/threatsync-management-api/revisions/2993b1908d27?raw)