The Aha! connector lets your AI agent act in each user's Aha! account. Each user connects their own Aha! access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.
- Tools
- 30
- What they doRead · write · destructive
- 18 · 11 · 118 read11 write1 destructive
- Users sign in with
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Aha! connection
In AgentKit > Connections, create an Aha! connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'aha'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Aha!:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'aha_features_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "aha"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Aha!:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="aha_features_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Aha! credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolaha_epic_getGet one Aha!Read-onlyGet Epic
Get one Aha! epic by ID or reference key. Returns the epic's id, reference_num, name, description, workflow_status, release, assignee, tags, features, dates, custom fields and url. Use List Epics to find epics.
Inputs
epic_idstringrequired- Numeric ID or reference key of the epic. Get it from List Epics. Example: APP-E-3.
aha_epics_listList epics in an Aha!Read-onlyList Epics
List epics in an Aha! product, filtered by search term, tag, assignee, status or update time. Returns pagination and epics with id, reference_num, name, created_at and url. Use Get Epic for full details.
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
assigned_to_userstring- ID or email of a user; only epics assigned to them. Example: pm@example.com.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the epic name. Example: login.
tagstring- Only epics with this tag. Example: mobile.
updated_sincestring- Only epics updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
workflow_statusstring- Workflow status ID or name; only epics in that status. Example: In development.
aha_feature_comments_listList comments on an Aha!Read-onlyList Feature Comments
List comments on an Aha! feature. Returns pagination and comments with id, body, user, created_at and url. Use Create Feature Comment to reply.
Inputs
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
aha_feature_getGet one Aha!Read-onlyGet Feature
Get one Aha! feature by ID or reference key. Returns the feature's id, reference_num, name, description, workflow_status, release, epic, assignee, tags, estimates, dates, requirements, custom fields and url. Use List Features to find features.
Inputs
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
aha_features_listList features across the Aha!Read-onlyList Features
List features across the Aha! account, filtered by search term, tag, assignee, status, custom fields or update time. Returns pagination and features with id, reference_num, name, created_at and url. Use List Release Features for one release and Get Feature for full details.
Inputs
assigned_to_userstring- ID or email of a user; only features assigned to them. Example: pm@example.com.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the feature name. Example: login.
tagstring- Only features with this tag. Example: mobile.
updated_sincestring- Only features updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
workflow_statusstring- Workflow status ID or name; only features in that status. Example: In development.
aha_goals_listList the goals defined in an Aha!Read-onlyList Goals
List the goals defined in an Aha! product. Returns pagination and goals with id, reference_num, name, created_at and url. Use this to see what features and initiatives support.
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
aha_idea_comments_listList internal comments on an Aha!Read-onlyList Idea Comments
List internal comments on an Aha! idea. Returns pagination and comments with id, body, user, created_at and url. Use Get Idea for the idea itself.
Inputs
idea_idstringrequired- Numeric ID or reference key of the idea. Get it from List Ideas. Example: APP-I-45.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
aha_idea_getGet one Aha!Read-onlyGet Idea
Get one Aha! idea by ID or reference key. Returns the idea's id, reference_num, name, description, workflow_status, votes, categories, tags, creator, promoted feature or epic, and url. Use List Ideas to find ideas.
Inputs
idea_idstringrequired- Numeric ID or reference key of the idea. Get it from List Ideas. Example: APP-I-45.
fieldsstring- Comma-separated fields to return, or * for all default fields. Example: name,description,votes.
aha_ideas_listList ideas in an Aha!Read-onlyList Ideas
List ideas in an Aha! product, filtered by search term, status, tag, assignee, creator or dates, sorted by recent, trending or popular. Returns pagination and ideas with id, name, reference_num, created_at, workflow_status, votes and url (more with fields). Use Get Idea for full details.
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
assigned_to_userstring- ID or email of a user; only ideas assigned to them. Example: pm@example.com.
created_sincestring- Only ideas created after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
fieldsstring- Comma-separated fields to return for each idea, or * for all default fields. Without it ideas come back in a minimal form. Example: name,description,votes.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the idea name. Example: login.
sortstring- Sort order: recent, trending or popular. Aha! defaults to trending. Example: recent.one of
recenttrendingpopular spamboolean- Set true to list ideas marked as spam instead. Example: true.
tagstring- Only ideas with this tag. Example: mobile.
updated_sincestring- Only ideas updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
workflow_statusstring- Workflow status ID or name; only ideas in that status. Example: In development.
aha_initiatives_listList initiatives in an Aha!Read-onlyList Initiatives
List initiatives in an Aha! product, filtered by search term, assignee, status, active state or update time. Returns pagination and initiatives with id, reference_num, name, created_at and url. Use the initiative name or ID when creating features or epics.
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
assigned_to_userstring- ID or email of a user; only initiatives assigned to them. Example: pm@example.com.
only_activeboolean- Set true to return only active initiatives. Example: true.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the initiative name. Example: login.
updated_sincestring- Only initiatives updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
workflow_statusstring- Workflow status ID or name; only initiatives in that status. Example: In development.
aha_me_getGet the Aha!Read-onlyGet Current User
Get the Aha! user who owns the API key. Returns the user's id, name, email, created and updated times, plus accounts or permissions when requested. Use this to confirm the connection.
Inputs
includestring- Extra data to include, such as accounts or permissions. Example: accounts.
aha_product_getGet one Aha!Read-onlyGet Product
Get one Aha! product (workspace) by ID or key. Returns the product's id, reference_prefix, name, description, workspace type, custom fields and url. Use List Products to find product keys.
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
aha_products_listList the products (workspaces) in the Aha!Read-onlyList Products
List the products (workspaces) in the Aha! account. Returns pagination and products with id, reference_prefix, name, product_line flag, created_at and url. Use this to get the product_id the release, epic, idea, goal and initiative tools need.
Inputs
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
updated_sincestring- Only products updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
aha_release_features_listList the features in one Aha!Read-onlyList Release Features
List the features in one Aha! release, with the same filters as List Features. Returns pagination and features with id, reference_num, name, created_at and url. Use Get Feature for full details.
Inputs
release_idstringrequired- Numeric ID or reference key of the release. Get it from List Releases. Example: APP-R-1.
assigned_to_userstring- ID or email of a user; only features assigned to them. Example: pm@example.com.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the feature name. Example: login.
tagstring- Only features with this tag. Example: mobile.
updated_sincestring- Only features updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
workflow_statusstring- Workflow status ID or name; only features in that status. Example: In development.
aha_release_getGet one Aha!Read-onlyGet Release
Get one Aha! release by ID or reference key. Returns the release's id, reference_num, name, dates, workflow_status, owner, theme, progress, feature counts and url. Use List Releases to find releases.
Inputs
release_idstringrequired- Numeric ID or reference key of the release. Get it from List Releases. Example: APP-R-1.
aha_releases_listList releases in an Aha!Read-onlyList Releases
List releases in an Aha! product, optionally searched or excluding shipped ones. Returns pagination and releases with id, reference_num, name, start_date, release_date, released flag, parking_lot flag and url. Use this to get a release_id for creating features and epics.
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
exclude_shippedboolean- Set true to leave out shipped releases. Example: true.
pageinteger- Page number, starting at 1. Example: 2.
parking_lotboolean- Set true to return only parking lot releases. Example: true.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the release name. Example: login.
updated_sincestring- Only releases updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
aha_requirements_listList the requirements of an Aha!Read-onlyList Feature Requirements
List the requirements of an Aha! feature. Returns pagination and requirements with id, reference_num, name, created_at and url. Use Create Requirement to add one.
Inputs
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
qstring- Search term matched against the requirement name. Example: login.
updated_sincestring- Only requirements updated after this UTC ISO 8601 timestamp. Example: 2026-01-01T00:00:00Z.
aha_users_listList users in the Aha!Read-onlyList Users
List users in the Aha! account, optionally by email. Returns pagination and users with id, name, email, enabled flag, created and updated times. Use this to find someone to assign work to.
Inputs
emailstring- Only the user with this email. Example: pm@example.com.
pageinteger- Page number, starting at 1. Example: 2.
per_pageinteger- Records per page, up to 200. Aha! defaults to 30. Example: 50.
aha_epic_createCreate an epic in an Aha!WriteCreate Epic
Create an epic in an Aha! release. Returns the new epic with its id, reference_num and url. Use Create Feature with the epic's name or ID to add features to it.
Inputs
namestringrequired- Name of the epic. Example: Enterprise readiness.
release_idstringrequired- Numeric ID or reference key of the release. Get it from List Releases. Example: APP-R-1.
assigned_to_userstring- Email address of the Aha! user to assign the epic to. Example: pm@example.com.
descriptionstring- Description of the epic; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
due_datestring- Due date in YYYY-MM-DD format. Example: 2026-07-01.
initiativestring- Name or ID of the initiative the epic belongs to. Example: Enterprise expansion.
start_datestring- Start date in YYYY-MM-DD format. Example: 2026-07-01.
tagsstring- Tags as comma-separated values. Example: mobile,security.
workflow_statusstring- Workflow status name to set; must be a valid status for the epic's workflow. Example: In design.
aha_epic_updateUpdate an Aha!WriteUpdate Epic
Update an Aha! epic's name, description, status, assignee, tags or dates. Returns the updated epic. Only the fields you pass change.
- Idempotent
Inputs
epic_idstringrequired- Numeric ID or reference key of the epic. Get it from List Epics. Example: APP-E-3.
assigned_to_userstring- Email address of the Aha! user to assign the epic to. Example: pm@example.com.
descriptionstring- Description of the epic; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
due_datestring- Due date in YYYY-MM-DD format. Example: 2026-07-01.
namestring- Name of the epic. Example: Enterprise readiness.
start_datestring- Start date in YYYY-MM-DD format. Example: 2026-07-01.
tagsstring- Tags as comma-separated values. Example: mobile,security.
workflow_statusstring- Workflow status name to set; must be a valid status for the epic's workflow. Example: In design.
aha_feature_comment_createPost a comment on an Aha!WriteCreate Feature Comment
Post a comment on an Aha! feature as the API key's user. Returns the new comment with its id, body and url. Watchers of the feature are notified by Aha!.
Inputs
bodystringrequired- Comment body; may include HTML. Example: <p>Design review is done.</p>
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
aha_feature_createCreate a feature in an Aha!WriteCreate Feature
Create a feature in an Aha! release. Returns the new feature with its id, reference_num and url. Features always belong to a release: use List Releases to pick one.
Inputs
namestringrequired- Name of the feature. Example: Single sign-on.
release_idstringrequired- Numeric ID or reference key of the release. Get it from List Releases. Example: APP-R-1.
assigned_to_userstring- Email address of the Aha! user to assign the feature to. Example: pm@example.com.
descriptionstring- Description of the feature; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
detailed_estimate_textstring- Detailed estimate: time with min, h, d, w, m (1d = 8h, 1w = 5d) or story points with p, depending on the workspace's capacity units. Example: 2d 4h.
due_datestring- Due date in YYYY-MM-DD format. Example: 2026-07-01.
epicstring- Name or ID of the epic the feature belongs to. Example: APP-E-3.
initiativestring- Name or ID of the initiative the feature belongs to. Example: Enterprise expansion.
start_datestring- Start date in YYYY-MM-DD format. Example: 2026-07-01.
tagsstring- Tags as comma-separated values. Example: mobile,security.
workflow_statusstring- Workflow status name to set; must be a valid status for the feature's workflow. Example: In design.
aha_feature_updateUpdate an Aha!WriteUpdate Feature
Update an Aha! feature's name, description, status, assignee, tags, dates, epic, initiative or estimate. Returns the updated feature. Only the fields you pass change. Tags passed here replace the existing tags.
- Idempotent
Inputs
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
assigned_to_userstring- Email address of the Aha! user to assign the feature to. Example: pm@example.com.
descriptionstring- Description of the feature; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
detailed_estimate_textstring- Detailed estimate: time with min, h, d, w, m (1d = 8h, 1w = 5d) or story points with p, depending on the workspace's capacity units. Example: 2d 4h.
due_datestring- Due date in YYYY-MM-DD format. Example: 2026-07-01.
epicstring- Name or ID of the epic the feature belongs to. Example: APP-E-3.
initiativestring- Name or ID of the initiative the feature belongs to. Example: Enterprise expansion.
namestring- Name of the feature. Example: Single sign-on.
start_datestring- Start date in YYYY-MM-DD format. Example: 2026-07-01.
tagsstring- Tags as comma-separated values. Example: mobile,security.
workflow_statusstring- Workflow status name to set; must be a valid status for the feature's workflow. Example: In design.
aha_idea_createCreate an idea in an Aha!WriteCreate Idea
Create an idea in an Aha! product on behalf of a person, who need not be an Aha! user. Returns the new idea with its id, reference_num and url. Set visibility to control who can see it; Aha! defaults to internal only.
Inputs
created_bystringrequired- Email of the person who submitted the idea; does not need to be an Aha! user. Example: customer@example.com.
namestringrequired- Name of the idea. Example: Dark mode.
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
assigned_to_userstring- Email address of the Aha! user to assign the idea to. Example: pm@example.com.
categoriesstring- Existing idea category names, comma-separated. Example: Integrations,Reporting.
descriptionstring- Description of the idea; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
initial_votesinteger- Number of votes to seed the idea with, when importing. Example: 3.
submitted_idea_portal_idstring- Numeric ID of the ideas portal the idea was submitted through. Recommended when the creator is a portal user. Example: 6776223543364558541.
tagsstring- Tags as comma-separated values. Example: mobile,security.
visibilitystring- Who can see the idea: aha (internal only, the default), creator, employee, employee_or_creator, creator_organization or public. Example: public.one of
ahacreatoremployeeemployee_or_creatorcreator_organizationpublic workflow_statusstring- Idea status name; must exist in the product's idea workflow. Example: Under consideration.
aha_idea_promotePromote an Aha!WritePromote Idea
Promote an Aha! idea into a feature, epic, initiative or requirement linked to the idea. Returns the idea with its promoted record. Features and epics need release_id, requirements need feature_id, initiatives need product_id.
Inputs
idea_idstringrequired- Numeric ID or reference key of the idea. Get it from List Ideas. Example: APP-I-45.
promotable_typestringrequired- What to promote the idea to: feature, epic, initiative or requirement. Example: feature.one of
featureepicinitiativerequirement feature_idstring- Feature ID or key; required when promoting to a requirement. Example: APP-12.
product_idstring- Product ID or key; required when promoting to an initiative. Example: APP.
release_idstring- Release ID or key; required when promoting to a feature or epic. Example: APP-R-1.
aha_idea_updateUpdate an Aha!WriteUpdate Idea
Update an Aha! idea's name, description, status, tags, categories, assignee or visibility. Returns the updated idea. Only the fields you pass change. Use Promote Idea to turn it into a feature or epic.
- Idempotent
Inputs
idea_idstringrequired- Numeric ID or reference key of the idea. Get it from List Ideas. Example: APP-I-45.
assigned_to_userstring- Email address of the Aha! user to assign the idea to. Example: pm@example.com.
categoriesstring- Existing idea category names, comma-separated. Example: Integrations.
descriptionstring- Description of the idea; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
namestring- Name of the idea. Example: Dark mode.
tagsstring- Tags as comma-separated values. Example: mobile,security.
visibilitystring- Who can see the idea: aha, creator, employee, employee_or_creator, creator_organization or public. Example: public.one of
ahacreatoremployeeemployee_or_creatorcreator_organizationpublic workflow_statusstring- Idea status name. Example: Planned.
aha_release_createCreate a release in an Aha!WriteCreate Release
Create a release in an Aha! product. Returns the new release with its id, reference_num, name, dates and url. Use Create Feature or Create Epic to add work to it.
Inputs
namestringrequired- Name of the release. Example: Q3 2026.
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
ownerstring- Email or ID of the release owner. Example: pm@example.com.
parking_lotboolean- Set true to make it a parking lot release for unscheduled work. Example: false.
release_datestring- Release date in YYYY-MM-DD format. Example: 2026-07-01.
start_datestring- Start date in YYYY-MM-DD format. Example: 2026-07-01.
themestring- Theme of the release; may include HTML. Example: <p>Enterprise readiness</p>
workflow_statusstring- Workflow status name for the release. Example: Planning.
aha_release_updateUpdate an Aha!WriteUpdate Release
Update an Aha! release's name, owner, theme, status or dates. Returns the updated release. Only the fields you pass change.
- Idempotent
Inputs
product_idstringrequired- Numeric ID or key of the Aha! product (workspace). Get it from List Products. Example: APP.
release_idstringrequired- Numeric ID or reference key of the release. Get it from List Releases. Example: APP-R-1.
namestring- Name of the release. Example: Q3 2026.
ownerstring- Email or ID of the release owner. Example: pm@example.com.
release_datestring- Release date in YYYY-MM-DD format. Example: 2026-07-01.
start_datestring- Start date in YYYY-MM-DD format. Example: 2026-07-01.
themestring- Theme of the release; may include HTML. Example: <p>Enterprise readiness</p>
workflow_statusstring- Workflow status name for the release. Example: Shipped.
aha_requirement_createAdd a requirement (sub-item) to an Aha!WriteCreate Requirement
Add a requirement (sub-item) to an Aha! feature. Returns the new requirement with its id, reference_num and url. Use List Feature Requirements to see existing ones.
Inputs
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
namestringrequired- Name of the requirement. Example: SAML support.
assigned_to_userstring- Email address of the Aha! user to assign the requirement to. Example: pm@example.com.
descriptionstring- Description of the requirement; may include HTML. Example: <p>Allow login with the customer's IdP.</p>
workflow_statusstring- Workflow status name to set; must be a valid status for the requirement's workflow. Example: In design.
aha_feature_deleteDelete an Aha!DestructiveDelete Feature
Delete an Aha! feature with its requirements. Returns an empty response on success. Deleted records go to the Aha! recycle bin.
- Idempotent
Inputs
feature_idstringrequired- Numeric ID or reference key of the feature. Get it from List Features. Example: APP-12.
No tools match.