Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Short.io

Scalekit connector
Open markdown

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

Tools
41
What they doRead · write · destructive
19 · 16 · 619 read16 write6 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 Short.io connection

    In AgentKit > Connections, create a Short.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 = 'shortio'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Short.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: 'shortio_bundle_templates_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Short.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
  • shortio_audit_log_listList audit log entries for a domain, optionally by user, action type or link.Read-only

    List Audit Log

    List audit log entries for a domain, optionally by user, action type or link. Returns records, nextPageToken. Get the domain ID from shortio_domains_list.

    Inputs

    domain_idnumberrequired
    Domain to fetch audit records for. Example: 123456
    action_typestring
    Filter records by operation type, e.g. "create", "update", "delete". Example: update
    limitinteger
    Maximum number of records to return. Example: 50
    link_idstring
    Filter records by link id, matched exactly as stored. Example: lnk_4Lx2_aBcD3fGh1
    page_tokenstring
    Pagination cursor from previous response. Example: example
    team_idinteger
    Team scope; current user must be owner. Example: 321
    user_idinteger
    Filter records by team member user id. Example: 98765
  • shortio_bundle_getGet one link bundle with its settings.Read-only

    Get Bundle

    Get one link bundle with its settings. Use shortio_bundle_links_list for its links.

    Inputs

    idstringrequired
    Bundle ULID id. Example: 01HZX5K9ABCDEF1234567890
  • shortio_bundle_templates_listList the templates available for link bundles (link-in-bio pages).Read-only

    List Bundle Templates

    List the templates available for link bundles (link-in-bio pages). Use this to get a TemplateId for shortio_bundle_create.

    Inputs

    This tool takes no inputs.

  • shortio_country_regions_listList the region codes available for a country.Read-only

    List Country Regions

    List the region codes available for a country. Use this to get region codes for shortio_link_region_create.

    Inputs

    countrystringrequired
    Country code. Example: USone of ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWEUQFQSQEQOQNQTXK
  • shortio_domain_getGet one domain's details and settings.Read-only

    Get Domain

    Get one domain's details and settings. Returns id, hostname, unicodeHostname, state, createdAt, updatedAt, TeamId, OrganizationId, hasFavicon, faviconURL. Get the domain ID from shortio_domains_list.

    Inputs

    domain_idintegerrequired
    Domain ID. Example: 123456
  • shortio_domains_listList the branded short domains in the account with IDs, hostnames and settings.Read-only

    List Domains

    List the branded short domains in the account with IDs, hostnames and settings. Returns a list of records with id, hostname, unicodeHostname, state, createdAt, updatedAt, TeamId, OrganizationId, hasFavicon, faviconURL. Use this first to get the domain ID and hostname other tools need.

    Inputs

    limitinteger
    Maximum number of domains to return. Example: 50
    no_team_idboolean
    Return only personal domains not assigned to a team. Example: true
    offsetinteger
    Number of domains to skip for pagination. Example: 0
    patternstring
    Hostname substring filter. Example: example
    team_idnumber
    Filter domains by team ID. Example: 321
  • shortio_folder_getGet one link folder with its default settings.Read-only

    Get Folder

    Get one link folder with its default settings. Get the folder ID from shortio_folders_list.

    Inputs

    domain_idintegerrequired
    Domain ID the folder belongs to. Example: 123456
    folder_idstringrequired
    Folder ID. Example: fld_01HZX5K9