Skip to main content

Aha

This Integration is part of the AHA Pack.#

Supported versions

Supported Cortex XSOAR versions: 6.5.0 and later.

Use the Aha! integration to list and manage Cortex XSOAR features from Aha. This integration was integrated and tested with API version September 30, 2022 release of Aha.

Configure Aha on Cortex XSOAR#

  1. Navigate to Settings > Integrations > Servers & Services.

  2. Search for Aha.

  3. Click Add instance to create and configure a new integration instance.

    ParameterDescriptionRequired
    Server URLTrue
    Project NameCheck the Aha! project name in the URL. Replace the <PROJECT_NAME> placeholder in the following : example.com.aha.io/products/<PROJECT_NAME>/featuresTrue
    Api KeyAPI Key to access the service REST API,True
    Trust any certificate (not secure)False
    Use system proxy settingsFalse
  4. Click Test to validate the URLs, token, and connection.

Commands#

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook. After you successfully execute a command, a DBot message appears in the War Room with the command details.

aha-get-features#


Lists all features from service, unless a specific feature is specified.

Base Command#

aha-get-features

Input#

Argument NameDescriptionRequired
from_dateShow features created after that date. Default is 2020-01-01.Optional
feature_nameThe name of a specific feature to retrieve.Optional
fieldsA comma-separated list of fields to include in the Aha! service response. Default is name,reference_num,id,created_at.Optional
pageThe specific results page to retrieve. Default is 1.Optional
per_pageThe maximum number of results per page. Default is 30.Optional

Context Output#

PathTypeDescription
AHA.Feature.idUUIDThe feature ID.
AHA.Feature.nameStringThe feature name.
AHA.Feature.reference_numStringThe feature reference number.
AHA.Feature.workflow_statusStringThe feature workflow status.
AHA.Feature.descriptionStringThe feature description.
AHA.Feature.created_atDateThe feature creation date.

Command example#

!aha-get-features !aha-get-features feature_name=DEMO-10 fields=workflow_status !aha-get-features fields=workflow_status page=2 per_page=30

aha-edit-feature#


Edit any of the following fields in a feature: Name, Status and Description.

Base Command#

aha-edit-feature

Input#

Argument NameDescriptionRequired
feature_nameThe name of the features to edit.Required
fieldsFields in JSON format to edit in a feature. Possible fields are name, description and status. Status should match Aha values under workflow_status. Example:" {"name": "name", "description": "desc", "status" : "Closed"}.Required

Context Output#

PathTypeDescription
AHA.Feature.idUUIDThe feature ID.
AHA.Feature.nameStringThe feature name.
AHA.Feature.reference_numStringThe feature reference number.
AHA.Feature.workflow_statusStringThe feature workflow status.
AHA.Feature.descriptionStringThe feature description.
AHA.Feature.created_atDateThe feature creation date.

Command example#

!aha-edit-feature feature_name=DEMO-10 fields=`{"name":"the_new_name", "description":"the_new_desc", "status":"Closed"}