Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to incident.io

Scalekit connector
Open markdown

The incident.io connector lets your AI agent act in each user's incident.io account. Each user connects their own incident.io access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 111 tools.

Tools
111
What they doRead · write · destructive
74 · 37 · 074 read37 write0 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 incident.io connection

    In AgentKit > Connections, create an incident.io 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 = 'incidentio'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize incident.io:', 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: 'incidentio_actions_list',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their incident.io 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
  • incidentio_action_getGet one incident action by its ID.Read-only

    Get Action

    Get one incident action by its ID. Returns the action's description, status, assignee and incident ID. Use incidentio_action_get when you have the action ID. Use incidentio_actions_list to find actions.

    Inputs

    action_idstringrequired
    Unique identifier for the action. Example: 01FCNDV6P870EA6S7TK1DSYD5H
  • incidentio_actions_listList incident actions (tasks to do while the incident is live), optionally for one incident, by incident mode or by creation and update dates.Read-only

    List Actions

    List incident actions (tasks to do while the incident is live), optionally for one incident, by incident mode or by creation and update dates. Returns actions with id, incident ID, description, status and assignee. Use incidentio_actions_list for in-incident tasks. Use incidentio_follow_ups_list for post-incident follow-ups.

    Inputs

    afterstring
    An action's ID. This endpoint will return a list of actions after this ID in relation to the API response order. Example: 01FDAG4SAP5TYPT98WGR2N7W91
    created_at_gtestring
    Only return actions whose created at is on or after this date (YYYY-MM-DD). Example: 2026-01-01
    created_at_ltestring
    Only return actions whose created at is on or before this date (YYYY-MM-DD). Example: 2026-01-31
    incident_idstring
    Find actions related to this incident. Example: 01FCNDV6P870EA6S7TK1DSYDG0
    incident_modestring
    Filter to actions from incidents of the given mode. If not set, only actions from `standard` and `retrospective` incidents are returned. One of: standard, retrospective, test, tutorial, stream. Example: standardone of standardretrospectivetesttutorialstream
    page_sizeinteger
    Number of records to return per page. Example: 25
    updated_at_gtestring
    Only return actions whose updated at is on or after this date (YYYY-MM-DD). Example: 2026-01-01
    updated_at_ltestring
    Only return actions whose updated at is on or before this date (YYYY-MM-DD). Example: 2026-01-31
  • incidentio_activity_log_entries_listList the activity log of an incident: status and severity changes, role assignments, messages pinned and other system events.Read-only

    List Incident Activity Log

    List the activity log of an incident: status and severity changes, role assignments, messages pinned and other system events. Returns activity entries with id, type, timestamp, actor and content. Use incidentio_activity_log_entries_list for the full audit of what happened. Use incidentio_timeline_items_list for curated timeline entries.

    Inputs

    incident_idstringrequired
    Incident whose activity you want to list. Example: 01G0J1EXE7AXZ2C93K61WBPYEH
    afterstring
    An entry's ID. This endpoint returns the entries that follow it. Example: 01FCNDV6P870EA6S7TK1DSYDG0
    idarray
    Return only the activity entries with these IDs. Example: ["01FCNDV6P870EA6S7TK1DSYDG0"]
    page_sizeinteger
    Number of records to return per page. Example: 25
  • incidentio_alert_getGet one alert by its ID.Read-only

    Get Alert

    Get one alert by its ID. Returns the alert's title, description, status, alert source, deduplication key, attributes, tags and timestamps. Use incidentio_alert_get when you have the alert ID. Use incidentio_alerts_list to find alerts.

    Inputs

    alert_idstringrequired
    Unique identifier for the alert. Example: 01FDAG4SAP5TYPT98WGR2N7W91
  • incidentio_alert_note_getGet one alert note by its ID.Read-only

    Get Alert Note

    Get one alert note by its ID. Returns the note's markdown content, author, the alert or alert group it belongs to, and timestamps. Use incidentio_alert_note_get when you have the note ID. Use incidentio_alert_notes_list to list notes on an alert.

    Inputs

    note_idstringrequired
    Unique identifier for the alert note. Example: 01J1X9J85C7Y12G8P8W8K55Q5Y
  • incidentio_alert_notes_listList the notes left on an alert or an alert group.Read-only

    List Alert Notes

    List the notes left on an alert or an alert group. Provide exactly one of alert_id or alert_group_id. Returns notes with id, markdown content, author and timestamps. Use incidentio_alert_notes_list to read responder notes on an alert. Use incidentio_alert_note_create to add one.

    Inputs

    afterstring
    An record's ID. This endpoint will return a list of records after this ID in relation to the API response order. Example: 01FDAG4SAP5TYPT98WGR2N7W91
    alert_group_idstring
    ID of the alert group to list notes for. Provide exactly one of alert_id or alert_group_id. Example: 01HB9Z8WANK6P870EA6S7TK1DS
    alert_idstring
    ID of the alert to list notes for. Provide exactly one of alert_id or alert_group_id. Example: 01FCNDV6P870EA6S7TK1DSYDG0
    page_sizeinteger
    Number of records to return per page. Example: 25
  • incidentio_alert_tags_listList the tags used on alerts, optionally filtered by a name search.Read-only

    List Alert Tags

    List the tags used on alerts, optionally filtered by a name search. Returns tags with id and name. Use incidentio_alert_tags_list to find existing tag names before tagging alerts or filtering incidentio_alerts_list.

    Inputs

    afterstring
    A tag's ID. This endpoint will return a list of tags after this ID in relation to the API response order. Example: 01GW2G3V0S59R238FAHPDS1R66
    page_sizeinteger
    Number of records to return per page. Example: 25
    searchstring
    Filter to tags whose name contains this value (case-insensitive) Example: noisy
  • incidentio_alerts_listList alerts received from your alert sources, with optional filters on status, alert source, deduplication key, tags and dates.Read-only

    List Alerts

    List alerts received from your alert sources, with optional filters on status, alert source, deduplication key, tags and dates. Returns alerts with id, title, description, status (firing or resolved), alert source, deduplication key, attributes and timestamps. Use incidentio_alerts_list to browse alerts. Use incidentio_alert_get for one alert and incidentio_incident_alerts_list to see which alerts are attached to an incident.

    Inputs

    afterstring
    If provided, pass this as the 'after' param to load the next page. Example: 01FCNDV6P870EA6S7TK1DSYDG0
    alert_source_one_ofarray
    Only return alerts from one of these alert source IDs. Example: ["01FCNDV6P870EA6S7TK1DSYDG0"]
    created_at_gtestring
    Only return alerts whose created at is on or after this date (YYYY-MM-DD). Example: 2026-01-01
    created_at_ltestring
    Only return alerts whose created at is on or before this date (YYYY-MM-DD). Example: 2026-01-31
    deduplication_keystring
    Only return alerts with exactly this deduplication key. Example: db-primary-cpu-high
    page_sizeinteger
    Number of records to return per page. Example: 25default 25
    status_one_ofarray
    Only return alerts in one of these statuses: firing or resolved. Example: ["firing"]
    tags_one_ofarray
    Only return alerts that have at least one of these tag names (see incidentio_alert_tags_list). Example: ["known issue"]
    updated_at_gtestring
    Only return alerts whose updated at is on or after this date (YYYY-MM-DD). Example: 2026-01-01
    updated_at_ltestring
    Only return alerts whose updated at is on or before this date (YYYY-MM-DD). Example: 2026-01-31
All 29 in Monitoring