Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Aha!

Scalekit connector
Open markdown

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

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. 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>
  3. Create the Aha! connection

    In AgentKit > Connections, create an Aha! connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. 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.actions
    const connector = 'aha'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { 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 call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'aha_features_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each 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 to execute_tool
Try in PlaygroundRequest a tool
  • aha_epic_getGet one Aha!Read-only

    Get 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-only

    List 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-only

    List 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-only

    Get 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-only

    List 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-only

    List 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-only

    List 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-only

    Get 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.