Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to AppVeyor

Scalekit connector
Open markdown

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

Tools
44
What they doRead · write · destructive
20 · 16 · 820 read16 write8 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 AppVeyor connection

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

    Each user opens the link once and enters their AppVeyor 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
  • appveyor_build_job_log_getDownload the console log of one build job as plain text.Read-only

    Get Build Job Log

    Download the console log of one build job as plain text. Returns the log text. Get the jobId from the jobs of a build (appveyor_project_build_get or appveyor_project_last_build_get).

    Inputs

    job_idstringrequired
    Build job ID. Example: 1696fh3a2w5ng99y.
  • appveyor_collaborator_getGet one collaborator and the roles available to assign.Read-only

    Get Collaborator

    Get one collaborator and the roles available to assign. Returns user (userId, fullName, email, roleId, roleName) and roles. Use appveyor_collaborators_list to find IDs.

    Inputs

    user_idintegerrequired
    Collaborator user ID, from appveyor_collaborators_list. Example: 2019.
  • appveyor_collaborators_listList the collaborators (users of other AppVeyor accounts given access) of the account.Read-only

    List Collaborators

    List the collaborators (users of other AppVeyor accounts given access) of the account. Returns collaborators with userId, fullName, email, roleId and roleName. Use appveyor_users_list for the account's own users.

    Inputs

    This tool takes no inputs.

  • appveyor_deployment_getGet one deployment with its project, build, environment and jobs.Read-only

    Get Deployment

    Get one deployment with its project, build, environment and jobs. Returns project and deployment (deploymentId, build, environment, jobs, status, started, finished). Use this to follow a deployment started by appveyor_deployment_start.

    Inputs

    deployment_idintegerrequired
    Deployment ID. Example: 19475.
  • appveyor_environment_deployments_listList the deployments made to one environment.Read-only

    List Environment Deployments

    List the deployments made to one environment. Returns environment and deployments with project, build, status, jobs and timestamps. Use appveyor_project_deployments_list for a project's deployments.

    Inputs

    environment_idintegerrequired
    Deployment environment ID (deploymentEnvironmentId), from appveyor_environments_list. Example: 14.
  • appveyor_environment_settings_getGet a deployment environment's settings.Read-only

    Get Environment Settings

    Get a deployment environment's settings. Returns environment with name, provider, environmentAccessKey and settings (providerSettings and environmentVariables). Edit the returned environment object and send it to appveyor_environment_update.

    Inputs

    environment_idintegerrequired
    Deployment environment ID (deploymentEnvironmentId), from appveyor_environments_list. Example: 14.
  • appveyor_environments_listList the deployment environments in the account.Read-only

    List Environments

    List the deployment environments in the account. Returns environments with deploymentEnvironmentId, name, provider and timestamps. Use appveyor_environment_settings_get for an environment's settings.

    Inputs

    This tool takes no inputs.

  • appveyor_project_branch_build_getGet the most recent build of one branch of a project.Read-only

    Get Project Branch Last Build

    Get the most recent build of one branch of a project. Returns project and build with its status and jobs. Use appveyor_project_last_build_get for the latest build on any branch.

    Inputs

    account_namestringrequired
    AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
    branchstringrequired
    Branch name. Example: main.
    project_slugstringrequired
    Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.