> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to AppVeyor

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.

**Authentication:** Bearer Token
**Categories:** Developer Tools
**Tools:** 44: 20 read, 16 write, 8 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=APPVEYOR)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".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](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "appveyor"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize AppVeyor:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="appveyor_collaborators_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their AppVeyor credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'appveyor_build_job_log_get',
  toolInput: {
    job_id: '<job_id>',
  },
  connector: 'appveyor',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="appveyor_build_job_log_get",
    tool_input={
        "job_id": "<job_id>",
    },
    connection_name="appveyor",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `appveyor_build_job_log_get`

Get Build Job Log · Read-only

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

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `job_id` (`string`, required): Build job ID. Example: 1696fh3a2w5ng99y.

Example input: `{"job_id":"<job_id>"}`

### `appveyor_collaborator_get`

Get Collaborator · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): Collaborator user ID, from appveyor_collaborators_list. Example: 2019.

Example input: `{"user_id":2019}`

### `appveyor_collaborators_list`

List Collaborators · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `appveyor_deployment_get`

Get Deployment · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deployment_id` (`integer`, required): Deployment ID. Example: 19475.

Example input: `{"deployment_id":19475}`

### `appveyor_environment_deployments_list`

List Environment Deployments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `environment_id` (`integer`, required): Deployment environment ID (deploymentEnvironmentId), from appveyor_environments_list. Example: 14.

Example input: `{"environment_id":14}`

### `appveyor_environment_settings_get`

Get Environment Settings · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `environment_id` (`integer`, required): Deployment environment ID (deploymentEnvironmentId), from appveyor_environments_list. Example: 14.

Example input: `{"environment_id":14}`

### `appveyor_environments_list`

List Environments · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `appveyor_project_branch_build_get`

Get Project Branch Last Build · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `branch` (`string`, required): Branch name. Example: main.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","branch":"<branch>","project_slug":"<project_slug>"}`

### `appveyor_project_build_get`

Get Project Build By Version · Read-only

Get one build of a project by its version string.
Returns project and build with status, commit details and jobs (jobId, name, status, testsCount, artifactsCount).
Use the jobId with appveyor_build_job_log_get to read a job's log.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `build_version` (`string`, required): Build version, as shown in AppVeyor. Example: 1.0.25.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","build_version":"<build_version>","project_slug":"<project_slug>"}`

### `appveyor_project_deployments_list`

List Project Deployments · Read-only

List a project's deployments, newest first.
Returns project and deployments with deploymentId, build, environment, status and timestamps.
Use appveyor_deployment_get for one deployment.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.
- `records_number` (`integer`, optional): Number of deployments to return, at most 20 (the default). Example: 20.
- `start_deployment_id` (`integer`, optional): Return deployments older than this deploymentId, for paging. Example: 4120.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_project_environment_variables_get`

Get Project Environment Variables · Read-only

Get a project's environment variables.
Returns an array of variables with name and value (value and isEncrypted).
Use appveyor_project_environment_variables_update to replace them.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_project_history_list`

List Project Build History · Read-only

List a project's builds, newest first, optionally for one branch.
Returns project and builds with buildId, version, branch, status, commit and timestamps.
Page back by passing the last buildId as start_build_id.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.
- `records_number` (`integer`, required): Number of builds to return. Example: 10.
- `branch` (`string`, optional): Only builds of this branch. Example: main.
- `start_build_id` (`integer`, optional): Return builds older than this buildId, for paging. Example: 18665.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>","records_number":10}`

### `appveyor_project_last_build_get`

Get Project Last Build · Read-only

Get a project with its most recent build.
Returns project and build (buildId, version, branch, commitId, status, jobs with jobId and status, started, finished).
Use appveyor_project_branch_build_get for the latest build of one branch and appveyor_project_build_get for a specific version.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_project_settings_get`

Get Project Settings · Read-only

Get a project's full settings as JSON.
Returns settings (the project object with repository, versionFormat, nextBuildNumber, configuration, nuGetFeed and securityDescriptor) and lists of images and build clouds.
Edit the returned settings object and send it to appveyor_project_update. Use appveyor_project_settings_yaml_get for the YAML form.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_project_settings_yaml_get`

Get Project Settings YAML · Read-only

Get a project's settings in appveyor.yml format.
Returns the YAML as plain text.
Use appveyor_project_settings_get for the JSON form.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_projects_list`

List Projects · Read-only

List all projects in the AppVeyor account the API key belongs to.
Returns projects with projectId, accountName, name, slug, repositoryType, repositoryName, repositoryBranch and their latest build.
Use this to find a project's account name and slug for the other project tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `appveyor_role_get`

Get Role · Read-only

Get one role with its permission groups.
Returns roleId, name, isSystem and groups (Projects, Environments, Account, Users, Roles, User) with each permission's name, description and allowed flag.
Edit the returned object and send it to appveyor_role_update.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `role_id` (`integer`, required): Role ID, from appveyor_roles_list. Example: 3040.

Example input: `{"role_id":3040}`

### `appveyor_roles_list`

List Roles · Read-only

List the roles in the account, including the system roles Administrator and User.
Returns roles with roleId, name, isSystem and created.
Use appveyor_role_get for a role's permissions.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `appveyor_user_get`

Get User · Read-only

Get one account user and the roles available to assign.
Returns user (userId, fullName, email, roleId, roleName, notification settings) and roles.
Use appveyor_users_list to find user IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): User ID, from appveyor_users_list. Example: 2019.

Example input: `{"user_id":2019}`

### `appveyor_users_list`

List Users · Read-only

List the users of the AppVeyor account.
Returns users with userId, fullName, email, roleId, roleName, notification settings and timestamps.
Use appveyor_collaborators_list for collaborators from other accounts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `appveyor_build_rerun`

Re-run Build · Write

Re-run a finished build, either fully or only its failed and cancelled jobs.
Returns the re-run build.
Get the buildId from appveyor_project_history_list or a build tool.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `build_id` (`integer`, required): ID of the build to re-run. Example: 642688.
- `re_run_incomplete` (`boolean`, optional): true to re-run only failed or cancelled jobs of a multi-job build; false (default) re-runs the whole build. Example: false.

Example input: `{"build_id":642688}`

### `appveyor_build_start`

Start Build · Write

Start a build of a project: the latest commit of a branch, a specific commit, or a pull request, optionally with extra environment variables.
Returns the queued build with buildId, version, branch, commitId and status.
Track it with appveyor_project_build_get or appveyor_project_last_build_get. Send pull_request_id for a PR build, otherwise branch (and optionally commit_id).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `account_name` (`string`, required): AppVeyor account name. Example: my-team.
- `project_slug` (`string`, required): Project slug. Example: my-web-app.
- `branch` (`string`, optional): Branch to build. Builds its most recent commit unless commit_id is set. Example: main.
- `commit_id` (`string`, optional): Commit SHA on the branch to build. Example: 3e9d9468.
- `environment_variables` (`object`, optional): Extra environment variables for this build, as name-value pairs. Example: {"my_var": "value", "another_var": "another value"}
- `pull_request_id` (`integer`, optional): Pull request number to build instead of a branch. Example: 3.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_collaborator_create`

Add Collaborator · Write

Give an existing AppVeyor user (from another account) access to this account with a role.
Returns no content on success (204).
Use appveyor_user_create to create a new user in this account instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): Email of the AppVeyor user to add. Example: jane@example.com.
- `role_id` (`integer`, required): Role to assign, from appveyor_roles_list. Example: 3040.

Example input: `{"email":"<email>","role_id":3040}`

### `appveyor_collaborator_update`

Update Collaborator · Write

Change a collaborator's role.
Returns no content on success (204).
Get role IDs from appveyor_roles_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `role_id` (`integer`, required): New role ID. Example: 3040.
- `user_id` (`integer`, required): Collaborator user ID. Example: 2018.

Example input: `{"role_id":3040,"user_id":2018}`

### `appveyor_deployment_cancel`

Cancel Deployment · Write

Cancel a running deployment.
Returns no content on success (204).
Get the deploymentId from appveyor_deployment_start or appveyor_project_deployments_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `deployment_id` (`integer`, required): ID of the deployment to cancel. Example: 19475.

Example input: `{"deployment_id":19475}`

### `appveyor_deployment_start`

Start Deployment · Write

Deploy a build of a project to a deployment environment.
Returns the deployment with deploymentId, build, environment, jobs and status.
Track it with appveyor_deployment_get. Use appveyor_deployment_cancel to stop it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `account_name` (`string`, required): AppVeyor account name. Example: my-team.
- `build_version` (`string`, required): Version of the build to deploy. Example: 1.2.0.
- `environment_name` (`string`, required): Name of the environment to deploy to, from appveyor_environments_list. Example: production.
- `project_slug` (`string`, required): Project slug. Example: my-web-app.
- `build_job_id` (`string`, optional): Job ID whose artifacts to deploy, when the build has several jobs. Example: sfke9239ydzf.
- `environment_variables` (`object`, optional): Extra environment variables for the deployment, as name-value pairs. Example: {"my_var": "value", "another_var": "another value"}

Example input: `{"account_name":"<account_name>","build_version":"<build_version>","environment_name":"<environment_name>","project_slug":"<project_slug>"}`

### `appveyor_environment_create`

Add Environment · Write

Create a deployment environment for a deployment provider such as FTP, Azure or Web Deploy.
Returns the new environment with deploymentEnvironmentId and environmentAccessKey.
Use its name with appveyor_deployment_start.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Environment name. Example: production.
- `provider` (`string`, required): Deployment provider, for example FTP, AzureBlob, AzureCS, WebDeploy, S3, NuGet, GitHub, Webhook or Agent. Example: FTP.
- `settings` (`object`, required): Provider settings and environment variables. providerSettings and environmentVariables are lists of {name, value: {value, isEncrypted}}; the setting names depend on the provider. Example: {"providerSettings": [{"name": "server", "value": {"value": "ftp.example.com", "isEncrypted": false}}, {"name": "password", "value": {"value": "secret", "isE...

Example input: `{"name":"<name>","provider":"<provider>","settings":{}}`

### `appveyor_environment_update`

Update Environment · Write

Update a deployment environment by sending the whole environment object.
Returns the updated environment.
Get the object from appveyor_environment_settings_get (its environment field), change it and send it back complete.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `environment` (`object`, required): The complete environment object (deploymentEnvironmentId, name, environmentAccessKey and settings with providerSettings, environmentVariables and provider) with your changes. Example: {"deploymentEnvironmentId": 3018, "name": "production", "environmentAccessKey": "gi3ttevuk7123", "settings": {"providerSettings": [{"name": "server", "value"...

Example input: `{"environment":{}}`

### `appveyor_project_build_number_update`

Update Project Build Number · Write

Set the build number the project's next build will use.
Returns no content on success (204).
Use this to align build numbers after a migration or reset.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `next_build_number` (`integer`, required): Build number for the next build. Example: 35.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","next_build_number":35,"project_slug":"<project_slug>"}`

### `appveyor_project_create`

Add Project · Write

Add a project to AppVeyor from a source repository.
Returns the new project with projectId, accountName, name and slug.
Use the returned slug with the other project tools.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `repository_name` (`string`, required): Repository name, for example owner/repo for GitHub. Example: my-org/my-web-app.
- `repository_provider` (`string`, required): Where the repository is hosted. Example: gitHub. One of: `gitHub`, `bitBucket`, `vso`, `gitLab`, `kiln`, `stash`, `git`, `mercurial`, `subversion`.

Example input: `{"repository_name":"<repository_name>","repository_provider":"gitHub"}`

### `appveyor_project_environment_variables_update`

Update Project Environment Variables · Write

Replace a project's environment variables with the list you send.
Returns no content on success (204).
Variables not in the list are removed, so start from appveyor_project_environment_variables_get.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.
- `variables` (`array`, required): Full list of variables. Each has a name and a value object with value and isEncrypted (true stores it encrypted). Example: [{"name": "api_key", "value": {"isEncrypted": true, "value": "secret"}}, {"name": "var1", "value": {"isEncrypted": false, "value": "new-value"}}]

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>","variables":[{"name":"api_key","value":{"isEncrypted":true,"value":"secret"}},{"name":"var1","value":{"isEncrypted":false,"value":"new-value"}}]}`

### `appveyor_project_update`

Update Project · Write

Update a project's settings by sending the whole project object.
Returns no content on success (204).
Get the current object from appveyor_project_settings_get (its settings field), change the fields you need and send it back complete; omitted fields may be reset.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project` (`object`, required): The complete project object (projectId, accountId, accountName, name, slug, versionFormat, nextBuildNumber, repository fields, configuration, securityDescriptor and the rest) as returned in settings by appveyor_project_settings_get, with your changes. Example: {"projectId": 43682, "accountId": 2, "accountName": "my-team", "name": "my-web-app", "slug": "my-web-app", "versionFormat": "1.0.{build}", "repositoryType": ...

Example input: `{"project":{}}`

### `appveyor_role_create`

Add Role · Write

Create a custom role.
Returns the new role with its permission groups, all not allowed.
Grant permissions with appveyor_role_update.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Role name. Example: Release managers.

Example input: `{"name":"<name>"}`

### `appveyor_role_update`

Update Role · Write

Update a role's name and permissions by sending the whole role object.
Returns the updated role.
Get the object from appveyor_role_get, set allowed on the permissions you want and send it back complete.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `role` (`object`, required): The complete role object: roleId, name, isSystem and groups, each with name and permissions (name, description, allowed). Example: {"roleId": 3040, "name": "Release managers", "isSystem": false, "groups": [{"name": "Projects", "permissions": [{"name": "RunProjectBuild", "description": "R...

Example input: `{"role":{}}`

### `appveyor_user_create`

Add User · Write

Add a user to the AppVeyor account with a role.
Returns no content on success (204).
Get role IDs from appveyor_roles_list. Use appveyor_collaborator_create to add an existing AppVeyor user from another account instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email` (`string`, required): User's email address. Example: john@example.com.
- `full_name` (`string`, required): User's full name. Example: John Smith.
- `role_id` (`integer`, required): Role to assign, from appveyor_roles_list (for example 4 Administrator, 5 User). Example: 5.
- `confirm_password` (`string`, optional): Same as password. Example: S3cure-pass-2026.
- `generate_password` (`boolean`, optional): true to generate a password and email it to the user instead of setting one. Example: true.
- `password` (`string`, optional): Initial password, when generate_password is false. Example: S3cure-pass-2026.

Example input: `{"email":"<email>","full_name":"<full_name>","role_id":5}`

### `appveyor_user_update`

Update User · Write

Update an account user's name, email, password, role or notification settings.
Returns no content on success (204).
Send the full user details; get the current values from appveyor_user_get.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email` (`string`, required): Email address. Example: john@example.com.
- `full_name` (`string`, required): Full name. Example: John Smith.
- `role_id` (`integer`, required): Role ID. Example: 4.
- `user_id` (`integer`, required): ID of the user to update. Example: 3019.
- `failed_build_notification` (`string`, optional): Email on failed builds: all, none or ownCommits. Example: all.
- `failed_deployment_notification` (`string`, optional): Email on failed deployments: all, none or ownCommits. Example: all.
- `notify_when_build_status_changed_only` (`boolean`, optional): Only email when the build status changes. Example: true.
- `password` (`string`, optional): New password; omit to keep the current one. Example: N3w-pass-2026.
- `successful_build_notification` (`string`, optional): Email on successful builds: all, none or ownCommits. Example: all.
- `successful_deployment_notification` (`string`, optional): Email on successful deployments: all, none or ownCommits. Example: all.

Example input: `{"email":"<email>","full_name":"<full_name>","role_id":4,"user_id":3019}`

### `appveyor_build_cancel`

Cancel Build · Destructive

Cancel a queued or running build.
Returns no content on success (204).
Use appveyor_build_delete to remove a finished build instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `build_version` (`string`, required): Version of the build to cancel. Example: 1.0.26.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","build_version":"<build_version>","project_slug":"<project_slug>"}`

### `appveyor_build_delete`

Delete Build · Destructive

Permanently delete a build from a project's history.
Returns no content on success (204).
Use appveyor_build_cancel to stop a running build.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `build_id` (`integer`, required): ID of the build to delete. Example: 642688.

Example input: `{"build_id":642688}`

### `appveyor_collaborator_delete`

Delete Collaborator · Destructive

Remove a collaborator's access to the account.
Returns no content on success (204).
Use appveyor_collaborators_list to find the ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): Collaborator user ID, from appveyor_collaborators_list. Example: 2019.

Example input: `{"user_id":2019}`

### `appveyor_environment_delete`

Delete Environment · Destructive

Permanently delete a deployment environment.
Returns no content on success (204).
Deployment history to it is no longer reachable from the environment.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `environment_id` (`integer`, required): Deployment environment ID (deploymentEnvironmentId), from appveyor_environments_list. Example: 14.

Example input: `{"environment_id":14}`

### `appveyor_project_build_cache_delete`

Delete Project Build Cache · Destructive

Delete a project's build cache so the next build starts clean.
Returns no content on success (204).
Use this when cached dependencies cause broken builds.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_project_delete`

Delete Project · Destructive

Permanently delete a project and its build history from AppVeyor.
Returns no content on success (204).
This cannot be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `account_name` (`string`, required): AppVeyor account name, as in the project URL ci.appveyor.com/project/<account>/<slug>. Example: my-team.
- `project_slug` (`string`, required): Project slug, as in the project URL ci.appveyor.com/project/<account>/<slug>. Get it from appveyor_projects_list. Example: my-web-app.

Example input: `{"account_name":"<account_name>","project_slug":"<project_slug>"}`

### `appveyor_role_delete`

Delete Role · Destructive

Delete a custom role.
Returns no content on success (204).
System roles cannot be deleted.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `role_id` (`integer`, required): Role ID, from appveyor_roles_list. Example: 3040.

Example input: `{"role_id":3040}`

### `appveyor_user_delete`

Delete User · Destructive

Remove a user from the AppVeyor account.
Returns no content on success (204).
Use appveyor_users_list to find the user ID.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`integer`, required): User ID, from appveyor_users_list. Example: 2019.

Example input: `{"user_id":2019}`

## Related

Other Developer Tools connectors ([all 200](/agentkit/connectors/?category=developer-tools)):

- [GitHub](/agentkit/connectors/github/): Scalekit connector, OAuth, 217 tools
- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [Linear](/agentkit/connectors/linear/): Scalekit connector, OAuth, 64 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
