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 December 02, 2022 release of Aha.

Configure Aha in Cortex#

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>/features.True
Api KeyAPI Key to access the service REST API.True
Trust any certificate (not secure)False
Use system proxy settingsFalse

Commands#

You can execute these commands from the 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 this 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 status description.
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#


You can edit the following fields in a feature: Name and Description.

Base Command#

aha-edit-feature

Input#

Argument NameDescriptionRequired
feature_nameThe name of the feature to edit.Required
fieldsFields in JSON format to edit in a feature. Possible fields are name and status. Status should match Aha values under workflow_status. Example:" {"name": "name", "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 status description.
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", "status":"Closed"}

aha-get-ideas#


Lists all ideas from service, unless a specific idea is specified.

Base Command#

aha-get-ideas

Input#

Argument NameDescriptionRequired
from_dateShow ideas created after this date. Default is 2020-01-01.Optional
idea_nameThe name of a specific idea 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.Idea.idUUIDThe idea ID.
AHA.Idea.nameStringThe idea name.
AHA.Idea.reference_numStringThe idea reference number.
AHA.Idea.workflow_statusStringThe idea status description.
AHA.Idea.descriptionStringThe idea description.
AHA.Idea.created_atDateThe idea creation date.

Command example#

!aha-get-ideas !aha-get-ideas idea_name=DEMO-I-2895 !aha-get-ideas idea_name=DEMO-I-2895 fields=workflow_status

aha-edit-idea#


Edit an idea status to Shipped.

Base Command#

aha-edit-idea

Input#

Argument NameDescriptionRequired
idea_nameThe name of the idea to edit.Required

Context Output#

PathTypeDescription
AHA.Idea.idUUIDThe idea ID.
AHA.Idea.nameStringThe idea name.
AHA.Idea.reference_numStringThe idea reference number.
AHA.Idea.workflow_statusStringThe idea status description.
AHA.Idea.descriptionStringThe idea description.
AHA.Idea.created_atDateThe idea creation date.

Command example#

!aha-edit-idea idea_name=DEMO-I-2895