@datafire/appveyor v6.0.0
@datafire/appveyor
Client library for AppVeyor REST API
Installation and Usage
npm install --save @datafire/appveyor
let appveyor = require('@datafire/appveyor').create({
apiToken: ""
});
.then(data => {
console.log(data);
});
Description
AppVeyor is a hosted continuous integration service which runs on Microsoft Windows. The AppVeyor REST API provides a RESTful way to interact with the AppVeyor service. This includes managing projects, builds, deployments, and the teams that build them.
Additional help and discussion of the AppVeyor REST API is available at http://help.appveyor.com/discussions
This Swagger definition is an unofficial description of the AppVeyor REST API maintained at https://github.com/kevinoid/appveyor-swagger Please report any issues or suggestions for this Swagger definition at https://github.com/kevinoid/appveyor-swagger/issues/new
API Conventions
Fields which are missing from update operations (PUT
requests) are
typically reset to their default values. So although most fields are not
technically required, they should usually be specified in practice.
Actions
encryptValue
Encrypt a value for use in StoredValue.
appveyor.encryptValue({
"body": {}
}, context)
Input
- input
object
- body required EncryptRequest
Output
- output
string
getBuildArtifacts
Get build artifacts
appveyor.getBuildArtifacts({
"jobId": ""
}, context)
Input
- input
object
- jobId required
string
: Build ID (jobId
property ofBuildJob
)
- jobId required
Output
- output
array
- items ArtifactModel
getBuildArtifact
Download build artifact
appveyor.getBuildArtifact({
"jobId": "",
"artifactFileName": ""
}, context)
Input
- input
object
- jobId required
string
: Build ID (jobId
property ofBuildJob
) - artifactFileName required
string
: File name (or path) of a build artifact file.
- jobId required
Output
- output
file
getBuildLog
Download build log
appveyor.getBuildLog({
"jobId": ""
}, context)
Input
- input
object
- jobId required
string
: Build ID (jobId
property ofBuildJob
)
- jobId required
Output
- output
file
startBuild
Start build of branch most recent commit
appveyor.startBuild({
"body": {
"accountName": "",
"projectSlug": ""
}
}, context)
Input
- input
object
- body required BuildStartRequest
Output
- output Build
reRunBuild
If reRunIncomplete
is true
and all jobs in the referenced build completed successfully, a 500 Internal Server Error is returned with the message "No failed or cancelled jobs in build with ID {buildId}".
appveyor.reRunBuild({
"body": {
"buildId": 0
}
}, context)
Input
- input
object
- body required ReRunBuildRequest
Output
- output Build
cancelBuild
Cancel build
appveyor.cancelBuild({
"accountName": "",
"projectSlug": "",
"buildVersion": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug - buildVersion required
string
: Build Version (version
property ofBuild
)
- accountName required
Output
Output schema unknown
getCollaborators
Get collaborators
appveyor.getCollaborators(null, context)
Input
This action has no parameters
Output
- output
array
- items UserAccount
addCollaborator
Add collaborator
appveyor.addCollaborator({
"body": {
"email": "",
"roleId": 0
}
}, context)
Input
- input
object
- body required CollaboratorAddition
Output
Output schema unknown
updateCollaborator
Update collaborator
appveyor.updateCollaborator({
"body": {
"userId": 0,
"roleId": 0
}
}, context)
Input
- input
object
- body required CollaboratorUpdate
Output
Output schema unknown
deleteCollaborator
Delete collaborator
appveyor.deleteCollaborator({
"userId": 0
}, context)
Input
- input
object
- userId required
integer
: User ID
- userId required
Output
Output schema unknown
getCollaborator
Get collaborator
appveyor.getCollaborator({
"userId": 0
}, context)
Input
- input
object
- userId required
integer
: User ID
- userId required
Output
- output UserAccountRolesResults
startDeployment
Start deployment
appveyor.startDeployment({
"body": {
"environmentName": "",
"accountName": "",
"projectSlug": "",
"buildVersion": ""
}
}, context)
Input
- input
object
- body required DeploymentStartRequest
Output
- output Deployment
cancelDeployment
Cancel deployment
appveyor.cancelDeployment({
"body": {
"deploymentId": 0
}
}, context)
Input
- input
object
- body required DeploymentCancellation
Output
Output schema unknown
getDeployment
Get deployment
appveyor.getDeployment({
"deploymentId": 0
}, context)
Input
- input
object
- deploymentId required
integer
: Deployment ID (deploymentId
property ofDeployment
)
- deploymentId required
Output
- output ProjectDeployment
getEnvironments
Get environments
appveyor.getEnvironments(null, context)
Input
This action has no parameters
Output
- output
array
addEnvironment
Add environment
appveyor.addEnvironment({
"body": {
"name": "",
"provider": "",
"settings": {}
}
}, context)
Input
- input
object
- body required DeploymentEnvironmentAddition
Output
updateEnvironment
Update environment
appveyor.updateEnvironment({
"body": null
}, context)
Input
- input
object
- body required DeploymentEnvironmentWithSettings
Output
deleteEnvironment
Delete environment
appveyor.deleteEnvironment({
"deploymentEnvironmentId": 0
}, context)
Input
- input
object
- deploymentEnvironmentId required
integer
: Deployment Environment ID (deploymentEnvironmentId
property ofDeploymentEnvironment
)
- deploymentEnvironmentId required
Output
Output schema unknown
getEnvironmentDeployments
Get environment deployments
appveyor.getEnvironmentDeployments({
"deploymentEnvironmentId": 0
}, context)
Input
- input
object
- deploymentEnvironmentId required
integer
: Deployment Environment ID (deploymentEnvironmentId
property ofDeploymentEnvironment
)
- deploymentEnvironmentId required
Output
getEnvironmentSettings
Get environment settings
appveyor.getEnvironmentSettings({
"deploymentEnvironmentId": 0
}, context)
Input
- input
object
- deploymentEnvironmentId required
integer
: Deployment Environment ID (deploymentEnvironmentId
property ofDeploymentEnvironment
)
- deploymentEnvironmentId required
Output
getProjects
Get projects
appveyor.getProjects(null, context)
Input
This action has no parameters
Output
- output
array
- items Project
addProject
Add project
appveyor.addProject({
"body": {
"repositoryProvider": "",
"repositoryName": ""
}
}, context)
Input
- input
object
- body required ProjectAddition
Output
- output Project
updateProject
Update project
appveyor.updateProject({
"body": {
"versionFormat": "",
"configuration": {}
}
}, context)
Input
- input
object
- body required ProjectWithConfiguration
Output
Output schema unknown
getPublicProjectStatusBadge
Get status badge image for a project with a public repository
appveyor.getPublicProjectStatusBadge({
"badgeRepoProvider": "",
"repoAccountName": "",
"repoSlug": ""
}, context)
Input
- input
object
- branch
string
: Repository Branch - svg
boolean
: Return an SVG image instead of PNG? Exclusive withretina
. - retina
boolean
: Return a larger image suitable for retina displays? Exclusive withsvg
. - passingText
string
: Text to show in badge when build is passing. - failingText
string
: Text to show in badge when build is failing. - pendingText
string
: Text to show in badge when build is pending. - badgeRepoProvider required
string
(values: bitBucket, gitHub): Repository provider supported for badges - repoAccountName required
string
: Account name with repository provider - repoSlug required
string
: Slug (URL component) of repository.
- branch
Output
- output
file
getProjectStatusBadge
Get project status badge image
appveyor.getProjectStatusBadge({
"statusBadgeId": ""
}, context)
Input
- input
object
- svg
boolean
: Return an SVG image instead of PNG? Exclusive withretina
. - retina
boolean
: Return a larger image suitable for retina displays? Exclusive withsvg
. - passingText
string
: Text to show in badge when build is passing. - failingText
string
: Text to show in badge when build is failing. - pendingText
string
: Text to show in badge when build is pending. - statusBadgeId required
string
: ID of the status badge (statusBadgeId
fromProjectWithConfiguration
).
- svg
Output
- output
file
getProjectBranchStatusBadge
Get project branch status badge image
appveyor.getProjectBranchStatusBadge({
"statusBadgeId": "",
"buildBranch": ""
}, context)
Input
- input
object
- svg
boolean
: Return an SVG image instead of PNG? Exclusive withretina
. - retina
boolean
: Return a larger image suitable for retina displays? Exclusive withsvg
. - passingText
string
: Text to show in badge when build is passing. - failingText
string
: Text to show in badge when build is failing. - pendingText
string
: Text to show in badge when build is pending. - statusBadgeId required
string
: ID of the status badge (statusBadgeId
fromProjectWithConfiguration
). - buildBranch required
string
: Build Branch
- svg
Output
- output
file
deleteProject
Delete project
appveyor.deleteProject({
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- accountName required
Output
Output schema unknown
getProjectLastBuild
Get project last build
appveyor.getProjectLastBuild({
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- accountName required
Output
- output ProjectBuildResults
getProjectArtifact
The job
parameter is mandatory if the build contains multiple jobs.
appveyor.getProjectArtifact({
"accountName": "",
"projectSlug": "",
"artifactFileName": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug - artifactFileName required
string
: File name (or path) of a build artifact file. - branch
string
: Repository Branch - tag
string
: A git (or other VCS) tag - job
string
: Name of the build job. - all
boolean
: Include not onlysuccessful
, but also jobs withfailed
, and - pr
boolean
: Include PR builds in the search results?
- accountName required
Output
- output
file
getProjectLastBuildBranch
Get project last branch build
appveyor.getProjectLastBuildBranch({
"accountName": "",
"projectSlug": "",
"buildBranch": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug - buildBranch required
string
: Build Branch
- accountName required
Output
- output ProjectBuildResults
getProjectBuildByVersion
Get project build by version
appveyor.getProjectBuildByVersion({
"accountName": "",
"projectSlug": "",
"buildVersion": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug - buildVersion required
string
: Build Version (version
property ofBuild
)
- accountName required
Output
- output ProjectBuildResults
deleteProjectBuildCache
Delete project build cache
appveyor.deleteProjectBuildCache({
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- accountName required
Output
Output schema unknown
getProjectDeployments
Get project deployments
appveyor.getProjectDeployments({
"accountName": "",
"projectSlug": "",
"recordsNumber": 0
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug - recordsNumber required
integer
: Number of results to include in the response. getProjectDeployments is documented to have a maximum of 20. It currently returns 500 Internal Server Error for recordsNumber <= 5. In the past it has returned 500 Internal Server Error for many different values which did not match the value used by the ci.appveyor.com web interface at the time. As of 2018-09-08, the value used by the web interface is 10.
- accountName required
Output
- output ProjectDeploymentsResults
getProjectHistory
Get project history
appveyor.getProjectHistory({
"recordsNumber": 0,
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- recordsNumber required
integer
: Number of results to include in the response. getProjectDeployments is documented to have a maximum of 20. It currently returns 500 Internal Server Error for recordsNumber <= 5. In the past it has returned 500 Internal Server Error for many different values which did not match the value used by the ci.appveyor.com web interface at the time. As of 2018-09-08, the value used by the web interface is 10. - startBuildId
integer
: MaximumbuildId
to include in the results (exclusive). - branch
string
: Repository Branch - accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- recordsNumber required
Output
- output ProjectHistory
getProjectSettings
Get project settings
appveyor.getProjectSettings({
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- accountName required
Output
- output ProjectSettingsResults
updateProjectBuildNumber
Update project build number
appveyor.updateProjectBuildNumber({
"body": {
"nextBuildNumber": 0
},
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- body required ProjectBuildNumberUpdate
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
Output
Output schema unknown
getProjectEnvironmentVariables
Get project environment variables
appveyor.getProjectEnvironmentVariables({
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- accountName required
Output
- output
array
- items StoredNameValue
updateProjectEnvironmentVariables
Update project environment variables
appveyor.updateProjectEnvironmentVariables({
"body": [],
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- body required
array
- items StoredNameValue
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- body required
Output
Output schema unknown
getProjectSettingsYaml
Get project settings in YAML
appveyor.getProjectSettingsYaml({
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- accountName required
Output
- output
string
updateProjectSettingsYaml
Update project settings in YAML
appveyor.updateProjectSettingsYaml({
"body": "",
"accountName": "",
"projectSlug": ""
}, context)
Input
- input
object
- body required
string
- accountName required
string
: AppVeyor account name (accountName
property ofUserAccount
) - projectSlug required
string
: Project Slug
- body required
Output
Output schema unknown
getRoles
Get roles
appveyor.getRoles(null, context)
Input
This action has no parameters
Output
- output
array
- items Role
addRole
Add role
appveyor.addRole({
"body": {
"name": ""
}
}, context)
Input
- input
object
- body required RoleAddition
Output
- output RoleWithGroups
updateRole
Update role
appveyor.updateRole({
"body": null
}, context)
Input
- input
object
- body required RoleWithGroups
Output
- output RoleWithGroups
deleteRole
Delete role
appveyor.deleteRole({
"roleId": 0
}, context)
Input
- input
object
- roleId required
integer
: Role ID
- roleId required
Output
Output schema unknown
getRole
Get role
appveyor.getRole({
"roleId": 0
}, context)
Input
- input
object
- roleId required
integer
: Role ID
- roleId required
Output
- output RoleWithGroups
getUsers
Get users
appveyor.getUsers(null, context)
Input
This action has no parameters
Output
- output
array
- items UserAccount
addUser
Add user
appveyor.addUser({
"body": {
"fullName": "",
"email": "",
"roleId": 0
}
}, context)
Input
- input
object
- body required UserAddition
Output
Output schema unknown
updateUser
Update user
appveyor.updateUser({
"body": null
}, context)
Input
- input
object
- body required UserAccount
Output
Output schema unknown
deleteUser
Delete user
appveyor.deleteUser({
"userId": 0
}, context)
Input
- input
object
- userId required
integer
: User ID
- userId required
Output
Output schema unknown
getUser
Get user
appveyor.getUser({
"userId": 0
}, context)
Input
- input
object
- userId required
integer
: User ID
- userId required
Output
- output UserAccountRolesResults
Definitions
AccessRightName
- AccessRightName
string
(values: Delete, Deploy, RunBuild, Update, View)
AceAccessRight
- AceAccessRight
object
- allowed
boolean
- name required AccessRightName
- allowed
AceAccessRightDefinition
- AceAccessRightDefinition
object
- description
string
- name required AccessRightName
- description
Artifact
- Artifact
object
- name
string
- path required
string
: Path glob of artifact files. - type ArtifactType
- name
ArtifactModel
- ArtifactModel
object
- created
string
- fileName
string
- name
string
- size
integer
- type ArtifactType
- url
string
: This property has not been observed in JSON responses, but is
- created
ArtifactType
- ArtifactType
string
(values: Auto, AzureCloudService, AzureCloudServiceConfig, ElasticBeanstalkPackage, File, NuGetPackage, OctopusPackage, SsdtPackage, WebDeployPackage, Zip): Possible values fromPush-AppveyorArtifact
cmdlet-Type
parameter.
Build
- Build
- branch
string
- buildId
integer
- message
string
- version
string
- created
string
- updated
string
- authorName
string
- authorUsername
string
- buildNumber
integer
- commitId
string
- committed
string
- committerName
string
- committerUsername
string
- finished
string
- isTag
boolean
- jobs
array
: Always empty in getProjectHistory and startDeployment responses.- items BuildJob
- messageExtended
string
- messages
array
- items BuildMessage
- projectId
integer
- pullRequestId
integer
- pullRequestName
string
- started
string
- status Status
- branch
BuildCloudName
- BuildCloudName
string
(values: azure-westus, gce, pro-ubuntu, pro-ubuntu18, pro-vs2013, pro-win2016, pro-vs2017, ubuntu)
BuildJob
- BuildJob
- created
string
- updated
string
- finished
string
- jobId
string
- name
string
- started
string
- status Status
- allowFailure
boolean
- artifactsCount
integer
- compilationErrorsCount
integer
- compilationMessagesCount
integer
- compilationWarningsCount
integer
- failedTestsCount
integer
- messagesCount
integer
- osType OSType
- passedTestsCount
integer
- testsCount
integer
- created
BuildLookupModel
- BuildLookupModel
object
- branch
string
- buildId
integer
- message
string
- version
string
- branch
BuildMessage
- BuildMessage
object
- category BuildMessageCategory
- created
string
- message
string
BuildMessageCategory
- BuildMessageCategory
string
(values: information, warning)
BuildMode
- BuildMode
string
(values: msbuild, none, script)
BuildNotificationFrequency
- BuildNotificationFrequency
string
(values: all, myCommits, none)
BuildStartRequest
- BuildStartRequest
object
- accountName required
string
- branch
string
- commitId
string
- environmentVariables
object
- projectSlug required
string
- pullRequestId
integer
: Can not be used withbranch
orcommitId
- accountName required
BuildWorkerImage
- BuildWorkerImage
object
- buildCloudName BuildCloudName
- buildWorkerImageId required
integer
- name required BuildWorkerImageName
- osType OSType
BuildWorkerImageName
- BuildWorkerImageName
string
(values: Previous Ubuntu, Previous Ubuntu1604, Previous Ubuntu1804, Previous Visual Studio 2013, Previous Visual Studio 2015, Previous Visual Studio 2017, Ubuntu, Ubuntu1604, Ubuntu1804, Visual Studio 2013, Visual Studio 2015, Visual Studio 2015 2, Visual Studio 2017, Visual Studio 2017 Preview, Visual Studio 2019 Preview, WMF 5, Windows Server 2019): Defines the available build worker image templates used to provision a virtual machine for a build. Images are updated regularly. "Previous" selects the previous version of an image, for use as a temporary workaround for regressions.
CollaboratorAddition
- CollaboratorAddition
object
: TechnicallyroleId
has default value 0 and is not required, but- email required
string
- roleId required
integer
- email required
CollaboratorUpdate
- CollaboratorUpdate
object
: TechnicallyuserId
androleId
have default value 0 and are not- roleId required
integer
- userId required
integer
- roleId required
DeployMode
- DeployMode
string
(values: providers, none, script)
Deployment
- Deployment
- build BuildLookupModel
- deploymentId
integer
- finished
string
- started
string
- status Status
- created
string
- updated
string
- build Build
- environment DeploymentEnvironment
- jobs
array
- items DeploymentJob
DeploymentCancellation
- DeploymentCancellation
object
- deploymentId required
integer
- deploymentId required
DeploymentEnvironment
- DeploymentEnvironment
- deploymentEnvironmentId
integer
- name
string
- provider DeploymentProviderType
- created
string
- updated
string
- accountId
integer
- projectsMode
integer
(values: 0, 1, 2): 0 is "Any project can be deployed to the environment" - securityDescriptor SecurityDescriptor
- tags
string
: Comma-separated list of environment tags for dynamic grouping.
- deploymentEnvironmentId
DeploymentEnvironmentAddition
- DeploymentEnvironmentAddition
object
- name required
string
- provider required DeploymentProviderType
- settings required DeploymentEnvironmentSettings
- name required
DeploymentEnvironmentDeploymentsResults
- DeploymentEnvironmentDeploymentsResults
object
- deployments required
array
- environment required DeploymentEnvironment
- deployments required
DeploymentEnvironmentLookupModel
- DeploymentEnvironmentLookupModel
object
- deploymentEnvironmentId
integer
- name
string
- provider DeploymentProviderType
- deploymentEnvironmentId
DeploymentEnvironmentProject
- DeploymentEnvironmentProject
object
- isSelected required
boolean
- name required
string
- projectId required
integer
- isSelected required
DeploymentEnvironmentSettings
- DeploymentEnvironmentSettings
object
- environmentVariables
array
- items StoredNameValue
- notifications
array
- providerSettings
array
- items StoredNameValue
- environmentVariables
DeploymentEnvironmentSettingsResults
- DeploymentEnvironmentSettingsResults
object
- environment DeploymentEnvironmentWithSettings
DeploymentEnvironmentWithSettings
- DeploymentEnvironmentWithSettings
- deploymentEnvironmentId
integer
- name
string
- provider DeploymentProviderType
- created
string
- updated
string
- accountId
integer
- projectsMode
integer
(values: 0, 1, 2): 0 is "Any project can be deployed to the environment" - securityDescriptor SecurityDescriptor
- tags
string
: Comma-separated list of environment tags for dynamic grouping. - environmentAccessKey
string
- projects
array
: Projects available for selection in UI. - selectedProjects
array
: Project IDs of selected projects- items
integer
- items
- settings DeploymentEnvironmentSettings
- deploymentEnvironmentId
DeploymentJob
- DeploymentJob
- created
string
- updated
string
- finished
string
- jobId
string
- name
string
- started
string
- status Status
- messagesCount
integer
- created
DeploymentLookupModel
- DeploymentLookupModel
object
- build BuildLookupModel
- deploymentId
integer
- finished
string
- started
string
- status Status
DeploymentNotificationFrequency
- DeploymentNotificationFrequency
string
(values: all, none)
DeploymentProvider
- DeploymentProvider
object
- onBranch
array
- items StringValueObject
- onEnvironmentVariables
array
- items StoredNameValue
- provider required DeploymentProviderType
- providerSettings
array
- items StoredNameValue
- onBranch
DeploymentProviderType
- DeploymentProviderType
string
(values: Agent, AzureBlob, AzureCS, AzureWebJob, BinTray, FTP, GitHub, NuGet, S3, SqlDatabase, WebDeploy, Webhook)
DeploymentStartRequest
- DeploymentStartRequest
object
- accountName required
string
- buildJobId
string
: Optional job id with artifacts if build contains multiple jobs. - buildVersion required
string
: Build to deploy - environmentName required
string
- environmentVariables
object
- projectSlug required
string
- accountName required
EncryptRequest
- EncryptRequest
object
- plainValue
string
- plainValue
EnvironmentDeploymentModel
- EnvironmentDeploymentModel
- build BuildLookupModel
- deploymentId
integer
- finished
string
- started
string
- status Status
- project ProjectLookupModel
Error
- Error
object
: Schema of object returned in 4XX and 5XX responses.- message required
string
- modelState
object
: When present, this property is a map of property names in the format
- message required
GroupName
- GroupName
string
(values: Account, BuildEnvironment, Deny, Environments, Projects, Roles, User, Users)
GroupPermissions
- GroupPermissions
object
- name required GroupName
- permissions required
array
- items PermissionState
HostEntry
- HostEntry
object
- host required
string
- ip required
string
- host required
HttpMethodRestricted
- HttpMethodRestricted
string
(values: GET, POST)
Job
- Job
- created
string
- updated
string
- finished
string
- jobId
string
- name
string
- started
string
- status Status
- created
MSBuildVerbosity
- MSBuildVerbosity
string
(values: quiet, minimal, normal, detailed)
NotificationProviderSettings
- NotificationProviderSettings
object
- provider required NotificationProviderType
- settings required NotificationSettings
NotificationProviderType
- NotificationProviderType
string
(values: Campfire, Email, GitHubPullRequest, HipChat, Slack, Webhook, VSOTeamRoom)
NotificationSettings
- NotificationSettings
object
: This type is the union of the settings types for each of the various- $type NotificationSettingsType
- account
string
- addCustomRequestBody
boolean
- authToken StoredValue
- bodyTemplate
string
- channel
string
- customRequestBody
string
- customRequestBodyContentType
string
- from
string
- headers
array
- items StoredNameValue
- headersValue
string
- incomingWebhookUrl
string
- method HttpMethodRestricted
- onBuildFailure
boolean
- onBuildStatusChanged
boolean
- onBuildSuccess
boolean
- password StoredValue
- recipients
array
- items StringValueObject
- recipientsValue
string
- room
string
- serverUrl
string
- subjectTemplate
string
- template
string
- url
string
- username
string
- vsoAccount
string
NotificationSettingsType
- NotificationSettingsType
string
(values: Appveyor.Models.CampfireNotificationSettings, Appveyor.Models, Appveyor.Models.EmailNotificationSettings, Appveyor.Models, Appveyor.Models.GitHubPullRequestNotificationSettings, Appveyor.Models, Appveyor.Models.HipChatNotificationSettings, Appveyor.Models, Appveyor.Models.SlackNotificationSettings, Appveyor.Models, Appveyor.Models.WebhookNotificationSettings, Appveyor.Models, Appveyor.Models.VSOTeamRoomNotificationSettings, Appveyor.Models)
NuGetFeed
- NuGetFeed
- created
string
- updated
string
- accountId
integer
- id
string
- isPrivateProject
boolean
- name
string
- nuGetFeedId
integer
- projectId
integer
- publishingEnabled
boolean
- created
OSServiceName
- OSServiceName
string
(values: iis, mongodb, msmq, mssql2008r2sp2, mssql2008r2sp2rs, mssql2012sp1, mssql2012sp1rs, mssql2014, mssql2014rs, mssql2016, mysql, postgresql)
OSType
- OSType
string
(values: Ubuntu, Windows)
PermissionName
- PermissionName
string
(values: ManageApplicationAuthorizations, UpdateAccountDetails, UpdateBillingDetails, ConfigureBuildEnvironment, DenyAllProjectsEnvironments, DeployToEnvironment, ManageEnvironments, UpdateEnvironmentSettings, ManageProjects, RunProjectBuild, UpdateProjectSettings, AddRole, DeleteRole, UpdateRoleDetails, ConfigureApiKeys, AddUser, DeleteUser, UpdateUserDetails): Available permission names. The names correspond to the following groups:
PermissionState
- PermissionState
object
- allowed
boolean
: State of the named permission.true
to allow,false
to deny, - description
string
- name required PermissionName
- allowed
PlatformName
- PlatformName
string
(values: ARM, Any CPU, x64, x86)
Project
- Project
- accountName
string
- name
string
- projectId required
integer
- slug
string
- created
string
- updated
string
- accountId
integer
- alwaysBuildClosedPullRequests
boolean
- builds
array
: Only non-empty for response from getProjects.- items Build
- currentBuildId
integer
- disablePullRequestWebhooks
boolean
- disablePushWebhooks
boolean
- enableDeploymentInPullRequests
boolean
- enableSecureVariablesInPullRequests
boolean
- enableSecureVariablesInPullRequestsFromSameRepo
boolean
- isGitHubApp
boolean
- isPrivate
boolean
- nuGetFeed NuGetFeed
- repositoryBranch
string
: Not present in response from addProject. - repositoryName required
string
- repositoryScm RepositoryScm
- repositoryType RepositoryProvider
- rollingBuilds
boolean
- rollingBuildsDoNotCancelRunningBuilds
boolean
- rollingBuildsOnlyForPullRequests
boolean
- saveBuildCacheInPullRequests
boolean
- securityDescriptor SecurityDescriptor
- skipBranchesWithoutAppveyorYml
boolean
- tags
string
: Comma-separated list of project tags for dynamic grouping.
- accountName
ProjectAddition
- ProjectAddition
object
:repositoryAuthentication
is only used for git, mercurial, subversionrepositoryProvider
.- repositoryAuthentication RepositoryAuthenticationType
- repositoryName required
string
: URL when repositoryProvider is git, mercurial, subversion username/project when repositoryProvider is gitHub - repositoryPassword
string
: Required if repositoryAuthentication is credentials - repositoryProvider required RepositoryProvider
- repositoryUsername
string
: Required if repositoryAuthentication is credentials
ProjectBranchesMode
- ProjectBranchesMode
string
(values: exclude, include)
ProjectBuildNumberUpdate
- ProjectBuildNumberUpdate
object
- nextBuildNumber required
integer
- nextBuildNumber required
ProjectBuildResults
ProjectConfiguration
- ProjectConfiguration
object
- afterBuildScripts
array
- items Script
- afterDeployScripts
array
- items Script
- afterTestScripts
array
- items Script
- artifacts
array
- items Artifact
- assemblyFileVersionFormat
string
- assemblyInfoFile
string
- assemblyInformationalVersionFormat
string
- assemblyVersionFormat
string
- beforeBuildScripts
array
- items Script
- beforeDeployScripts
array
- items Script
- beforePackageScripts
array
- items Script
- beforeTestScripts
array
- items Script
- branchesMode ProjectBranchesMode
- buildCloud
array
- items StringValueObject
- buildMode BuildMode
- buildScripts
array
: Only set/used whenbuildMode
isscript
.- items Script
- cacheEntries
array
- items StringValueObject
- cloneDepth
integer
- cloneFolder
string
- cloneScripts
array
- items Script
- configuration
array
- items StringValueObject
- configureNuGetAccountSource
boolean
- configureNuGetProjectSource
boolean
- deployMode DeployMode
- deployScripts
array
- items Script
- deployments
array
- items DeploymentProvider
- disableNuGetPublishForOctopusPackages
boolean
- disableNuGetPublishOnPullRequests
boolean
- doNotIncrementBuildNumberOnPullRequests
boolean
- dotnetCsprojAssemblyVersionFormat
string
- dotnetCsprojFile
string
- dotnetCsprojFileVersionFormat
string
- dotnetCsprojInformationalVersionFormat
string
- dotnetCsprojPackageVersionFormat
string
- dotnetCsprojVersionFormat
string
- environmentVariables
array
- items StoredNameValue
- environmentVariablesMatrix
array
- items StoredNameValueMatrix
- excludeBranches
array
- items StringValueObject
- forceHttpsClone
boolean
- hostsEntries
array
- items HostEntry
- hotFixScripts
array
- items Script
- includeBranches
array
- items StringValueObject
- includeNuGetReferences
boolean
- initScripts
array
- items Script
- installScripts
array
- items Script
- matrixAllowFailures
array
: Although the names and values are not enforced, the combinations which are meaningful are documented at https://www.appveyor.com/docs/build-configuration/#allow-failing-jobs- items StoredNameValueMatrix
- matrixExcept
array
- items StoredNameValueMatrix
- matrixExclude
array
- items StoredNameValueMatrix
- matrixFastFinish
boolean
- matrixOnly
array
- items StoredNameValueMatrix
- maxJobs
integer
- msBuildInParallel
boolean
- msBuildProjectFileName
string
- msBuildVerbosity MSBuildVerbosity
- notifications
array
- onBuildErrorScripts
array
- items Script
- onBuildFinishScripts
array
- items Script
- onBuildSuccessScripts
array
- items Script
- onlyCommitsFiles
array
- items StringValueObject
- operatingSystem
array
- items
object
- value required BuildWorkerImageName
- items
- packageAspNetCoreProjects
boolean
- packageAzureCloudServiceProjects
boolean
- packageDotnetConsoleProjects
boolean
- packageNuGetProjects
boolean
- packageNuGetSymbols
boolean
- packageWebApplicationProjects
boolean
- packageWebApplicationProjectsBeanstalk
boolean
- packageWebApplicationProjectsOctopus
boolean
- packageWebApplicationProjectsXCopy
boolean
- patchAssemblyInfo
boolean
- patchDotnetCsproj
boolean
- platform
array
- items
object
- value required PlatformName
- items
- services
array
- items
object
- value required OSServiceName
- items
- shallowClone
boolean
- skipBranchWithPullRequests
boolean
- skipCommitsFiles
array
- items StringValueObject
- skipNonTags
boolean
- skipTags
boolean
- stacks
array
- items UnknownType
- testAssemblies
array
- items StringValueObject
- testCategories
array
- items StringValueObject
- testCategoriesMatrix
array
- items
object
- categories
array
- items StringValueObject
- categories
- items
- testCategoriesMode
string
(values: exclude, include) - testMode TestMode
- testScripts
array
: Only set/used whentestMode
isscript
.- items Script
- xamarinRegisterAndroidProduct
boolean
- xamarinRegisterIosProduct
boolean
- afterBuildScripts
ProjectDeployment
- ProjectDeployment
object
- deployment required Deployment
- project required Project
ProjectDeploymentModel
- ProjectDeploymentModel
- build BuildLookupModel
- deploymentId
integer
- finished
string
- started
string
- status Status
- environment DeploymentEnvironmentLookupModel
ProjectDeploymentsResults
- ProjectDeploymentsResults
object
- deployments
array
- items ProjectDeploymentModel
- project Project
- deployments
ProjectHistory
ProjectLookupModel
- ProjectLookupModel
object
- accountName
string
- name
string
- projectId required
integer
- slug
string
- accountName
ProjectSettingsResults
- ProjectSettingsResults
object
- buildClouds
array
- items StringValueObject
- defaultImageName
string
- images
array
- items BuildWorkerImage
- project Project
- settings ProjectWithConfiguration
- buildClouds
ProjectWithConfiguration
- ProjectWithConfiguration
object
- accountName
string
- name
string
- projectId required
integer
- slug
string
- created
string
- updated
string
- accountId
integer
- alwaysBuildClosedPullRequests
boolean
- builds
array
: Only non-empty for response from getProjects.- items Build
- currentBuildId
integer
- disablePullRequestWebhooks
boolean
- disablePushWebhooks
boolean
- enableDeploymentInPullRequests
boolean
- enableSecureVariablesInPullRequests
boolean
- enableSecureVariablesInPullRequestsFromSameRepo
boolean
- isGitHubApp
boolean
- isPrivate
boolean
- nuGetFeed NuGetFeed
- repositoryBranch
string
: Not present in response from addProject. - repositoryName required
string
- repositoryScm RepositoryScm
- repositoryType RepositoryProvider
- rollingBuilds
boolean
- rollingBuildsDoNotCancelRunningBuilds
boolean
- rollingBuildsOnlyForPullRequests
boolean
- saveBuildCacheInPullRequests
boolean
- securityDescriptor SecurityDescriptor
- skipBranchesWithoutAppveyorYml
boolean
- tags
string
: Comma-separated list of project tags for dynamic grouping. - buildPriority
integer
- configuration required ProjectConfiguration
- customYmlName
string
- ignoreAppveyorYml
boolean
- nextBuildNumber
integer
- repositoryAuthentication RepositoryAuthenticationType
- repositoryUsername
string
- scheduleCrontabExpression
string
: Build schedule as an NCrontab Expression. See https://github.com/atifaziz/NCrontab/wiki/Crontab-Expression - sshPublicKey
string
- statusBadgeId
string
- versionFormat required
string
- webhookId
string
- webhookUrl
string
- accountName
ReRunBuildRequest
- ReRunBuildRequest
object
- buildId required
integer
- reRunIncomplete
boolean
: SetreRunIncomplete
set tofalse
(default value) for full build re-run. Set it set totrue
to rerun only failed or cancelled jobs in multijob build.
- buildId required
RepositoryAuthenticationType
- RepositoryAuthenticationType
string
(values: credentials, ssh)
RepositoryProvider
- RepositoryProvider
string
(values: bitBucket, git, gitHub, gitLab, kiln, mercurial, stash, subversion, vso)
RepositoryScm
- RepositoryScm
string
(values: git, mercurial, subversion)
Role
- Role: Technically
roleId
has default value 0 and is not required, but- created
string
- updated
string
- isSystem
boolean
- name required
string
- roleId required
integer
- created
RoleAce
- RoleAce
object
- accessRights
array
- items AceAccessRight
- isAdmin
boolean
- name
string
- roleId
integer
- accessRights
RoleAddition
- RoleAddition
object
- name required
string
- name required
RoleWithGroups
- RoleWithGroups
- created
string
- updated
string
- isSystem
boolean
- name required
string
- roleId required
integer
- groups
array
- items GroupPermissions
- created
Script
- Script
object
- language ScriptLanguage
- script required
string
ScriptLanguage
- ScriptLanguage
string
(values: cmd, ps, pwsh, sh)
SecurityDescriptor
- SecurityDescriptor
object
- accessRightDefinitions
array
- items AceAccessRightDefinition
- roleAces
array
- items RoleAce
- accessRightDefinitions
Status
- Status
string
(values: cancelled, cancelling, failed, queued, running, starting, success)
StoredNameValue
- StoredNameValue
object
- name required
string
- value required StoredValue
- name required
StoredNameValueMatrix
- StoredNameValueMatrix
object
- variables StoredNameValue
StoredValue
- StoredValue
object
- isEncrypted
boolean
- value
string
: Encrypted values can be created using the encryptValue operation.
- isEncrypted
StringValueObject
- StringValueObject
object
- value
string
- value
TestMode
- TestMode
string
(values: auto, none, script)
Timestamped
- Timestamped
object
- created
string
- updated
string
- created
UnknownType
- UnknownType
string
(values: unknown): A schema for values which have an undocumented/unknown type.
UserAccount
- UserAccount
- created
string
- updated
string
- accountId
integer
- accountName
string
- email required
string
- fullName required
string
- isCollaborator
boolean
- isOwner
boolean
- pageSize
integer
- password
string
- roleId
integer
- roleName
string
- twoFactorAuthEnabled
boolean
- userId
integer
- created
UserAccountRolesResults
- UserAccountRolesResults
object
: The roles property contains all roles, not only the role for which the user is a member.- roles
array
- items Role
- user UserAccount
- roles
UserAccountSettings
- UserAccountSettings
object
- failedBuildNotification required BuildNotificationFrequency
- failedDeploymentNotification required DeploymentNotificationFrequency
- notifyWhenBuildStatusChangedOnly
boolean
: Note that this value istrue
on user creation, but behaves as - notifyWhenDeploymentStatusChangedOnly
boolean
: Note that this value istrue
on user creation, but behaves as - successfulBuildNotification required BuildNotificationFrequency
- successfulDeploymentNotification required DeploymentNotificationFrequency
UserAddition
- UserAddition
object
- confirmPassword
string
- email required
string
- fullName required
string
- generatePassword
boolean
- password
string
- roleId required
integer
: TechnicallyroleId
has default value 0 and is not required, but
- confirmPassword