Release API Contracts

Last Update: 8/11/2017

AgentArtifactDefinition

Field Type
alias string
artifactType AgentArtifactType
details string
name string
version string

AgentArtifactType

Enum Value Notes
xamlBuild
build
jenkins
fileShare
nuget
tfsOnPrem
gitHub
tFGit
externalTfsBuild
custom
tfvc

AgentBasedDeployPhase

Extends: DeployPhase

Field Type
deploymentInput AgentDeploymentInput

AgentDeploymentInput

Extends: DeploymentInput

Field Type
imageId int32
parallelExecution ExecutionInput

ApprovalOptions

Field Type
autoTriggeredAndPreviousEnvironmentApprovedCanBeSkipped boolean
enforceIdentityRevalidation boolean
releaseCreatorCanBeApprover boolean
requiredApproverCount int32
timeoutInMinutes int32

ApprovalStatus

Enum Value Notes
undefined
pending
approved
rejected
reassigned
canceled
skipped

ApprovalType

Enum Value Notes
undefined
preDeploy
postDeploy
all

Artifact

Field Type Notes
alias string Gets or sets alias.
definitionReference dictionary (string, ArtifactSourceReference) Gets or sets definition reference. e.g. {"project":{"id":"fed755ea-49c5-4399-acea-fd5b5aa90a6c","name":"myProject"},"definition":{"id":"1","name":"mybuildDefinition"},"connection":{"id":"1","name":"myConnection"}}
isPrimary boolean Gets or sets as artifact is primary or not.
sourceId string
type string Gets or sets type. It can have value as 'Build', 'Jenkins', 'GitHub', 'Nuget', 'Team Build (external)', 'ExternalTFSBuild', 'Git', 'TFVC', 'ExternalTfsXamlBuild'.

ArtifactContributionDefinition

Field Type
artifactType string
artifactTypeStreamMapping dictionary (string, string)
browsableArtifactTypeMapping dictionary (string, string)
dataSourceBindings array (DataSourceBinding)
displayName string
downloadTaskId string
endpointTypeId string
inputDescriptors array (InputDescriptor)
name string
uniqueSourceIdentifier string

ArtifactFilter

Field Type
sourceBranch string
tags array (string)

ArtifactInstanceData

Field Type
accountName string
authenticationToken string
tfsUrl string
version string

ArtifactMetadata

Field Type Notes
alias string Sets alias of artifact.
instanceReference BuildVersion Sets instance reference of artifact. e.g. for build artifact it is build number.

ArtifactProvider

Field Type
id int32
name string
sourceUri string
version string

ArtifactSourceId

Field Type
artifactTypeId string
sourceIdInputs array (SourceIdInput)

ArtifactSourceIdsQueryResult

Field Type
artifactSourceIds array (ArtifactSourceId)

ArtifactSourceReference

Field Type
id string
name string

ArtifactSourceTrigger

Extends: ReleaseTriggerBase

Field Type Notes
artifactAlias string Artifact source alias for Artifact Source trigger type
triggerConditions array (ArtifactFilter)

ArtifactTypeDefinition

Field Type
displayName string
inputDescriptors array (InputDescriptor)
name string
uniqueSourceIdentifier string

ArtifactVersion

Field Type
alias string
defaultVersion BuildVersion
errorMessage string
sourceId string
versions array (BuildVersion)

ArtifactVersionQueryResult

Field Type
artifactVersions array (ArtifactVersion)

AuditAction

Enum Value Notes
add
update
delete

AuthorizationHeaderFor

Enum Value Notes
revalidateApproverIdentity
onBehalfOf

AutoTriggerIssue

Field Type
issue Issue
issueSource IssueSource
project ProjectReference
releaseDefinitionReference ReleaseDefinitionShallowReference
releaseTriggerType ReleaseTriggerType

AzureKeyVaultVariableGroupProviderData

Extends: VariableGroupProviderData

Field Type
lastRefreshedOn date-time
serviceEndpointId GUID
vault string

AzureKeyVaultVariableValue

Extends: VariableValue

Field Type
contentType string
enabled boolean
expires date-time

BaseDeploymentInput

Field Type Notes
condition string
jobCancelTimeoutInMinutes int32 Gets or sets the job cancel timeout in minutes for deployment which are cancelled by user for this release environment
overrideInputs dictionary (string, string)
shareOutputVariables boolean
timeoutInMinutes int32 Gets or sets the job execution timeout in minutes for deployment which are queued against this release environment

BuildVersion

Field Type
id string
name string
sourceBranch string
sourceRepositoryId string
sourceRepositoryType string
sourceVersion string

Change

Represents a change associated with a build.

Field Type Notes
author IdentityRef The author of the change.
changeType string The type of change. "commit", "changeset", etc.
displayUri string The location of a user-friendly representation of the resource.
id string Something that identifies the change. For a commit, this would be the SHA1. For a TFVC changeset, this would be the changeset id.
location string The location of the full representation of the resource.
message string A description of the change. This might be a commit message or changeset description.
timestamp date-time A timestamp for the change.

Condition

Field Type
conditionType ConditionType
name string
value string

ConditionType

Enum Value Notes
undefined
event
environmentState
artifact

ConfigurationVariableValue

Field Type Notes
isSecret boolean Gets or sets as variable is secret or not.
value string Gets or sets value of the configuration variable.

Consumer

Field Type
consumerId int32
consumerName string

ContinuousDeploymentTriggerIssue

Extends: AutoTriggerIssue

Field Type
artifactType string
artifactVersionId string
sourceId string

ControlOptions

Field Type
alwaysRun boolean
continueOnError boolean
enabled boolean

DataSourceBinding

Field Type
dataSourceName string
endpointId string
endpointUrl string
parameters dictionary (string, string)
resultSelector string
resultTemplate string
target string

DataSourceBindingBase

Field Type
dataSourceName string
endpointId string
endpointUrl string
parameters dictionary (string, string)
resultSelector string
resultTemplate string
target string

DefinitionEnvironmentReference

Field Type
definitionEnvironmentId int32
definitionEnvironmentName string
releaseDefinitionId int32
releaseDefinitionName string

Demand

Field Type
name string
value string

Deployment

Field Type
_links ReferenceLinks
attempt int32
conditions array (Condition)
definitionEnvironmentId int32
deploymentStatus DeploymentStatus
id int32
lastModifiedBy IdentityRef
lastModifiedOn date-time
operationStatus DeploymentOperationStatus
postDeployApprovals array (ReleaseApproval)
preDeployApprovals array (ReleaseApproval)
queuedOn date-time
reason DeploymentReason
release ReleaseReference
releaseDefinition ReleaseDefinitionShallowReference
releaseEnvironment ReleaseEnvironmentShallowReference
requestedBy IdentityRef
requestedFor IdentityRef
scheduledDeploymentTime date-time
startedOn date-time

DeploymentApprovalCompletedEvent

Field Type
approval ReleaseApproval
project ProjectReference
release Release

DeploymentApprovalPendingEvent

Field Type
approval ReleaseApproval
approvalOptions ApprovalOptions
completedApprovals array (ReleaseApproval)
data dictionary (string, object)
deployment Deployment
isMultipleRankApproval boolean
pendingApprovals array (ReleaseApproval)
project ProjectReference
release Release

DeploymentAttempt

Field Type Notes
attempt int32
deploymentId int32
errorLog string Error log to show any unexpected error that occurred during executing deploy step
hasStarted boolean The time at which the deployment started, and null if it has not been deployed yet
id int32
job ReleaseTask
lastModifiedBy IdentityRef
lastModifiedOn date-time
operationStatus DeploymentOperationStatus
queuedOn date-time
reason DeploymentReason
releaseDeployPhases array (ReleaseDeployPhase)
requestedBy IdentityRef
requestedFor IdentityRef
runPlanId GUID
status DeploymentStatus
tasks array (ReleaseTask)

DeploymentAuthorizationInfo

Field Type
authorizationHeaderFor AuthorizationHeaderFor
resources array (string)
tenantId string
vstsAccessTokenKey string

DeploymentAuthorizationOwner

Enum Value Notes
automatic
deploymentSubmitter
firstPreDeploymentApprover

DeploymentCompletedEvent

Field Type
comment string
data dictionary (string, object)
deployment Deployment
environment ReleaseEnvironment
project ProjectReference

DeploymentExpands

Enum Value Notes
all
deploymentOnly
approvals
artifacts

DeploymentInput

Extends: BaseDeploymentInput

Field Type
demands array (Demand)
enableAccessToken boolean
queueId int32
skipArtifactsDownload boolean

DeploymentJob

Field Type
job ReleaseTask
tasks array (ReleaseTask)

DeploymentManualInterventionPendingEvent

Field Type
deployment Deployment
emailRecipients array (GUID)
environmentOwner IdentityRef
manualIntervention ManualIntervention
project ProjectReference
release Release

DeploymentOperationStatus

Enum Value Notes
undefined
queued
scheduled
pending
approved
rejected
deferred
queuedForAgent
phaseInProgress
phaseSucceeded
phasePartiallySucceeded
phaseFailed
canceled
phaseCanceled
manualInterventionPending
queuedForPipeline
all

DeploymentQueryParameters

Field Type
artifactSourceId string
artifactTypeId string
artifactVersions array (string)
deploymentStatus DeploymentStatus
environments array (DefinitionEnvironmentReference)
expands DeploymentExpands
isDeleted boolean
latestDeploymentsOnly boolean
maxDeploymentsPerEnvironment int32
maxModifiedTime date-time
minModifiedTime date-time
operationStatus DeploymentOperationStatus
queryOrder ReleaseQueryOrder

DeploymentReason

Enum Value Notes
none
manual
automated
scheduled

DeploymentStartedEvent

Field Type
environment ReleaseEnvironment
project ProjectReference
release Release

DeploymentStatus

Enum Value Notes
undefined
notDeployed
inProgress
succeeded
partiallySucceeded
failed
all

DeployPhase

Field Type
name string
phaseType DeployPhaseTypes
rank int32
workflowTasks array (WorkflowTask)

DeployPhaseStatus

Enum Value Notes
undefined
notStarted
inProgress
partiallySucceeded
succeeded
failed
canceled
skipped

DeployPhaseTypes

Enum Value Notes
undefined
agentBasedDeployment
runOnServer
machineGroupBasedDeployment

EmailRecipients

Field Type
emailAddresses array (string)
tfsIds array (GUID)

EnvironmentExecutionPolicy

Defines policy on environment queuing at Release Management side queue. We will send to Environment Runner [creating pre-deploy and other steps] only when the policies mentioned are satisfied.

Field Type Notes
concurrencyCount int32 This policy decides, how many environments would be with Environment Runner.
queueDepthCount int32 Queue depth in the EnvironmentQueue table, this table keeps the environment entries till Environment Runner is free [as per it's policy] to take another environment for running.

EnvironmentOptions

Field Type
emailNotificationType string
emailRecipients string
enableAccessToken boolean
publishDeploymentStatus boolean
skipArtifactsDownload boolean
timeoutInMinutes int32

EnvironmentRetentionPolicy

Field Type
daysToKeep int32
releasesToKeep int32
retainBuild boolean

EnvironmentStatus

Enum Value Notes
undefined
notStarted
inProgress
succeeded
canceled
rejected
queued
scheduled
partiallySucceeded

ExecutionInput

Field Type
parallelExecutionType ParallelExecutionTypes

FavoriteItem

Class to represent favorite entry

Field Type Notes
data string Application specific data for the entry
id GUID Unique Id of the the entry
name string Display text for favorite entry
type string Application specific favorite entry type. Empty or Null represents that Favorite item is a Folder

Folder

Field Type
createdBy IdentityRef
createdOn date-time
description string
lastChangedBy IdentityRef
lastChangedDate date-time
path string

FolderPathQueryOrder

Enum Value Notes
none No order
ascending Order by folder name and path ascending.
descending Order by folder name and path descending.

IdentityRef

Field Type
directoryAlias string
displayName string
id string
imageUrl string
inactive boolean
isAadIdentity boolean
isContainer boolean
profileUrl string
uniqueName string
url string

InputDataType

Enumerates data types that are supported as subscription input values.

Enum Value Notes
none No data type is specified.
string Represents a textual value.
number Represents a numberic value.
boolean Represents a value of true or false.
guid Represents a Guid.
uri Represents a URI.

InputDescriptor

Describes an input for subscriptions.

Field Type Notes
dependencyInputIds array (string) The ids of all inputs that the value of this input is dependent on.
description string Description of what this input is used for
groupName string The group localized name to which this input belongs and can be shown as a header for the container that will include all the inputs in the group.
hasDynamicValueInformation boolean If true, the value information for this input is dynamic and should be fetched when the value of dependency inputs change.
id string Identifier for the subscription input
inputMode InputMode Mode in which the value of this input should be entered
isConfidential boolean Gets whether this input is confidential, such as for a password or application key
name string Localized name which can be shown as a label for the subscription input
properties dictionary (string, object) Custom properties for the input which can be used by the service provider
type string Underlying data type for the input value. When this value is specified, InputMode, Validation and Values are optional.
useInDefaultDescription boolean Gets whether this input is included in the default generated action description.
validation InputValidation Information to use to validate this input's value
valueHint string A hint for input value. It can be used in the UI as the input placeholder.
values InputValues Information about possible values for this input

InputMode

Mode in which a subscription input should be entered (in a UI)

Enum Value Notes
none This input should not be shown in the UI
textBox An input text box should be shown
passwordBox An password input box should be shown
combo A select/combo control should be shown
radioButtons Radio buttons should be shown
checkBox Checkbox should be shown(for true/false values)
textArea A multi-line text area should be shown

InputValidation

Describes what values are valid for a subscription input

Field Type
dataType InputDataType
isRequired boolean
maxLength int32
maxValue decimal
minLength int32
minValue decimal
pattern string
patternMismatchErrorMessage string

InputValue

Information about a single value for an input

Field Type Notes
data dictionary (string, object) Any other data about this input
displayValue string The text to show for the display of this value
value string The value to store for this input

InputValues

Information about the possible/allowed values for a given subscription input

Field Type Notes
defaultValue string The default value to use for this input
error InputValuesError Errors encountered while computing dynamic values.
inputId string The id of the input
isDisabled boolean Should this input be disabled
isLimitedToPossibleValues boolean Should the value be restricted to one of the values in the PossibleValues (True) or are the values in PossibleValues just a suggestion (False)
isReadOnly boolean Should this input be made read-only
possibleValues array (InputValue) Possible values that this input can take

InputValuesError

Error information related to a subscription input value.

Field Type Notes
message string The error message.

InputValuesQuery

Field Type Notes
currentValues dictionary (string, string)
inputValues array (InputValues) The input values to return on input, and the result from the consumer on output.
resource object Subscription containing information about the publisher/consumer and the current input values

Issue

Field Type
issueType string
message string

IssueSource

Enum Value Notes
none
user
system

MachineGroupBasedDeployPhase

Extends: DeployPhase

Field Type
deploymentInput MachineGroupDeploymentInput

MachineGroupDeploymentInput

Extends: DeploymentInput

Field Type
deploymentHealthOption string
healthPercent int32
tags array (string)

MailMessage

Field Type
body string
cC EmailRecipients
inReplyTo string
messageId string
replyBy date-time
replyTo EmailRecipients
sections array (MailSectionType)
senderType SenderType
subject string
to EmailRecipients

MailSectionType

Enum Value Notes
details
environments
issues
testResults
workItems
releaseInfo

ManualIntervention

Field Type
approver IdentityRef
comments string
createdOn date-time
id int32
instructions string
modifiedOn date-time
name string
release ReleaseShallowReference
releaseDefinition ReleaseDefinitionShallowReference
releaseEnvironment ReleaseEnvironmentShallowReference
status ManualInterventionStatus
taskInstanceId GUID
url string

ManualInterventionStatus

Enum Value Notes
unknown
pending
rejected
approved
canceled

ManualInterventionUpdateMetadata

Field Type
comment string
status ManualInterventionStatus

MappingDetails

Field Type
mappings dictionary (string, InputValue)

Metric

Field Type
name string
value int32

MultiConfigInput

Extends: ParallelExecutionInputBase

Field Type
multipliers string

MultiMachineInput

Extends: ParallelExecutionInputBase

ParallelExecutionInputBase

Extends: ExecutionInput

Field Type
continueOnError boolean
maxNumberOfAgents int32

ParallelExecutionTypes

Enum Value Notes
none
multiConfiguration
multiMachine

ProcessParameters

Field Type
dataSourceBindings array (DataSourceBindingBase)
inputs array (TaskInputDefinitionBase)
sourceDefinitions array (TaskSourceDefinitionBase)

ProjectReference

Field Type Notes
id GUID Gets the unique identifier of this field.
name string Gets name of project.

PropertiesCollection

Field Type Notes
count int32 Implements ICollection<KeyValuePair<String,Object>>.Count/>
item object
keys array (string)
values array (string)

PropertySelector

Field Type
properties array (string)
selectorType PropertySelectorType

PropertySelectorType

Enum Value Notes
inclusion
exclusion

QueuedReleaseData

Field Type
projectId GUID
queuePosition int32
releaseId int32

RealtimeReleaseEvent

Field Type
projectId GUID
releaseId int32

The class to represent a collection of REST reference links. Example: { self: { href: "http://localhost:8080/tfs/DefaultCollection/_apis/wit/workItems/1" } }

Field Type Notes
links dictionary (string, object) The readonly view of the links. Because Reference links are readonly, we only want to expose them as read only.

Release

Field Type Notes
_links ReferenceLinks Gets links to access the release.
artifacts array (Artifact) Gets or sets the list of artifacts.
comment string Gets or sets comment.
createdBy IdentityRef Gets or sets the identity who created.
createdOn date-time Gets date on which it got created.
definitionSnapshotRevision int32 Gets revision number of definition snapshot.
description string Gets or sets description of release.
environments array (ReleaseEnvironment) Gets list of environments.
id int32 Gets the unique identifier of this field.
keepForever boolean Whether to exclude the release from retention policies.
logsContainerUrl string Gets logs container url.
modifiedBy IdentityRef Gets or sets the identity who modified.
modifiedOn date-time Gets date on which it got modified.
name string Gets name.
poolName string Gets pool name.
projectReference ProjectReference Gets or sets project reference.
properties PropertiesCollection
reason ReleaseReason Gets reason of release.
releaseDefinition ReleaseDefinitionShallowReference Gets releaseDefinitionReference which specifies the reference of the release definition to which this release is associated.
releaseNameFormat string Gets release name format.
status ReleaseStatus Gets status.
tags array (string) Gets or sets list of tags.
url string
variableGroups array (VariableGroup) Gets the list of variable groups.
variables dictionary (string, ConfigurationVariableValue) Gets or sets the dictionary of variables.

ReleaseAbandonedEvent

Field Type
project ProjectReference
release Release

ReleaseApproval

Field Type Notes
approvalType ApprovalType Gets or sets the type of approval.
approvedBy IdentityRef Gets the identity who approved.
approver IdentityRef Gets or sets the identity who should approve.
attempt int32 Gets or sets attempt which specifies as which deployment attempt it belongs.
comments string Gets or sets comments for approval.
createdOn date-time Gets date on which it got created.
history array (ReleaseApprovalHistory) Gets history which specifies all approvals associated with this approval.
id int32 Gets the unique identifier of this field.
isAutomated boolean Gets or sets as approval is automated or not.
isNotificationOn boolean
modifiedOn date-time Gets date on which it got modified.
rank int32 Gets or sets rank which specifies the order of the approval. e.g. Same rank denotes parallel approval.
release ReleaseShallowReference Gets releaseReference which specifies the reference of the release to which this approval is associated.
releaseDefinition ReleaseDefinitionShallowReference Gets releaseDefinitionReference which specifies the reference of the release definition to which this approval is associated.
releaseEnvironment ReleaseEnvironmentShallowReference Gets releaseEnvironmentReference which specifies the reference of the release environment to which this approval is associated.
revision int32 Gets the revision number.
status ApprovalStatus Gets or sets the status of the approval.
trialNumber int32
url string Gets url to access the approval.

ReleaseApprovalHistory

Field Type
approver IdentityRef
changedBy IdentityRef
comments string
createdOn date-time
modifiedOn date-time
revision int32

ReleaseApprovalPendingEvent

Field Type
approval ReleaseApproval
approvalOptions ApprovalOptions
completedApprovals array (ReleaseApproval)
definitionName string
deployment Deployment
environmentId int32
environmentName string
environments array (ReleaseEnvironment)
isMultipleRankApproval boolean
pendingApprovals array (ReleaseApproval)
releaseCreator string
releaseName string
title string
webAccessUri string

ReleaseArtifact

Field Type
artifactProvider ArtifactProvider
artifactType string
definitionData string
definitionId int32
description string
id int32
name string
releaseId int32

ReleaseCondition

Extends: Condition

Field Type
result boolean

ReleaseCreatedEvent

Field Type
project ProjectReference
release Release

ReleaseDefinition

Field Type Notes
_links ReferenceLinks Gets links to access the release definition.
artifacts array (Artifact) Gets or sets the list of artifacts.
comment string Gets or sets comment.
createdBy IdentityRef Gets or sets the identity who created.
createdOn date-time Gets date on which it got created.
description string Gets or sets the description.
environments array (ReleaseDefinitionEnvironment) Gets or sets the list of environments.
id int32 Gets the unique identifier of this field.
lastRelease ReleaseReference Gets the reference of last release.
modifiedBy IdentityRef Gets or sets the identity who modified.
modifiedOn date-time Gets date on which it got modified.
name string Gets or sets the name.
path string Gets or sets the path.
properties PropertiesCollection Gets or sets properties.
releaseNameFormat string Gets or sets the release name format.
retentionPolicy RetentionPolicy
revision int32 Gets the revision number.
source ReleaseDefinitionSource Gets or sets source of release definition.
tags array (string) Gets or sets list of tags.
triggers array (ReleaseTriggerBase) Gets or sets the list of triggers.
url string Gets url to access the release definition.
variableGroups array (int32) Gets or sets the list of variable groups.
variables dictionary (string, ConfigurationVariableValue) Gets or sets the dictionary of variables.

ReleaseDefinitionApprovals

Field Type
approvalOptions ApprovalOptions
approvals array (ReleaseDefinitionApprovalStep)

ReleaseDefinitionApprovalStep

Extends: ReleaseDefinitionEnvironmentStep

Field Type
approver IdentityRef
isAutomated boolean
isNotificationOn boolean
rank int32

ReleaseDefinitionDeployStep

Extends: ReleaseDefinitionEnvironmentStep

Field Type Notes
tasks array (WorkflowTask) The list of steps for this definition.

ReleaseDefinitionEnvironment

Field Type
conditions array (Condition)
demands array (Demand)
deployPhases array (DeployPhase)
deployStep ReleaseDefinitionDeployStep
environmentOptions EnvironmentOptions
executionPolicy EnvironmentExecutionPolicy
id int32
name string
owner IdentityRef
postDeployApprovals ReleaseDefinitionApprovals
preDeployApprovals ReleaseDefinitionApprovals
processParameters ProcessParameters
properties PropertiesCollection
queueId int32
rank int32
retentionPolicy EnvironmentRetentionPolicy
runOptions dictionary (string, string)
schedules array (ReleaseSchedule)
variables dictionary (string, ConfigurationVariableValue)

ReleaseDefinitionEnvironmentStep

Field Type
id int32

ReleaseDefinitionEnvironmentSummary

Field Type
id int32
lastReleases array (ReleaseShallowReference)
name string

ReleaseDefinitionEnvironmentTemplate

Field Type
canDelete boolean
category string
description string
environment ReleaseDefinitionEnvironment
iconTaskId GUID
iconUri string
id GUID
name string

ReleaseDefinitionExpands

Enum Value Notes
none
environments
artifacts
triggers
variables
tags
lastRelease

ReleaseDefinitionQueryOrder

Enum Value Notes
idAscending
idDescending
nameAscending
nameDescending

ReleaseDefinitionRevision

Field Type Notes
apiVersion string Gets api-version for revision object.
changedBy IdentityRef Gets the identity who did change.
changedDate date-time Gets date on which it got changed.
changeType AuditAction Gets type of change.
comment string Gets comments for revision.
definitionId int32 Get id of the definition.
definitionUrl string Gets definition url.
revision int32 Get revision number of the definition.

ReleaseDefinitionShallowReference

Field Type Notes
_links ReferenceLinks Gets the links to related resources, APIs, and views for the release definition.
id int32 Gets the unique identifier of release definition.
name string Gets or sets the name of the release definition.
url string Gets the REST API url to access the release definition.

ReleaseDefinitionSource

Enum Value Notes
undefined
restApi
userInterface
ibiza
portalExtensionApi

ReleaseDefinitionSummary

Field Type
environments array (ReleaseDefinitionEnvironmentSummary)
releaseDefinition ReleaseDefinitionShallowReference
releases array (Release)

ReleaseDeployPhase

Field Type
deploymentJobs array (DeploymentJob)
errorLog string
id int32
manualInterventions array (ManualIntervention)
phaseType DeployPhaseTypes
rank int32
runPlanId GUID
status DeployPhaseStatus

ReleaseEnvironment

Field Type Notes
conditions array (ReleaseCondition) Gets list of conditions.
createdOn date-time Gets date on which it got created.
definitionEnvironmentId int32 Gets definition environment id.
demands array (Demand) Gets demands.
deployPhasesSnapshot array (DeployPhase) Gets list of deploy phases snapshot.
deploySteps array (DeploymentAttempt) Gets deploy steps.
environmentOptions EnvironmentOptions Gets environment options.
id int32 Gets the unique identifier of this field.
modifiedOn date-time Gets date on which it got modified.
name string Gets name.
nextScheduledUtcTime date-time Gets next scheduled UTC time.
owner IdentityRef Gets the identity who is owner for release environment.
postApprovalsSnapshot ReleaseDefinitionApprovals Gets list of post deploy approvals snapshot.
postDeployApprovals array (ReleaseApproval) Gets list of post deploy approvals.
preApprovalsSnapshot ReleaseDefinitionApprovals Gets list of pre deploy approvals snapshot.
preDeployApprovals array (ReleaseApproval) Gets list of pre deploy approvals.
processParameters ProcessParameters Gets process parameters.
queueId int32 Gets queue id.
rank int32 Gets rank.
release ReleaseShallowReference Gets release reference which specifies the reference of the release to which this release environment is associated.
releaseCreatedBy IdentityRef Gets the identity who created release.
releaseDefinition ReleaseDefinitionShallowReference Gets releaseDefinitionReference which specifies the reference of the release definition to which this release environment is associated.
releaseDescription string Gets release description.
releaseId int32 Gets release id.
scheduledDeploymentTime date-time Gets schedule deployment time of release environment.
schedules array (ReleaseSchedule) Gets list of schedules.
status EnvironmentStatus Gets environment status.
timeToDeploy double Gets time to deploy.
triggerReason string Gets trigger reason.
variables dictionary (string, ConfigurationVariableValue) Gets the dictionary of variables.
workflowTasks array (WorkflowTask) Gets list of workflow tasks.

ReleaseEnvironmentCompletedEvent

Field Type
createdByName string
definitionId int32
definitionName string
environment ReleaseEnvironment
environmentId int32
projectName string
reason DeploymentReason
releaseCreatedBy IdentityRef
releaseLogsUri string
releaseName string
status string
title string
webAccessUri string

ReleaseEnvironmentShallowReference

Field Type Notes
_links ReferenceLinks Gets the links to related resources, APIs, and views for the release environment.
id int32 Gets the unique identifier of release environment.
name string Gets or sets the name of the release environment.
url string Gets the REST API url to access the release environment.

ReleaseEnvironmentUpdateMetadata

Field Type Notes
comment string Gets or sets comment.
scheduledDeploymentTime date-time Gets or sets scheduled deployment time.
status EnvironmentStatus Gets or sets status of environment.

ReleaseExpands

Enum Value Notes
none
environments
artifacts
approvals
manualInterventions
variables
tags

ReleaseQueryOrder

Enum Value Notes
descending
ascending

ReleaseReason

Enum Value Notes
none
manual
continuousIntegration
schedule
individualCI
batchedCI

ReleaseReference

Field Type Notes
_links ReferenceLinks Gets links to access the release.
artifacts array (Artifact) Gets list of artifacts.
createdBy IdentityRef Gets the identity who created.
createdOn date-time Gets date on which it got created.
description string Gets description.
id int32 Gets the unique identifier of this field.
modifiedBy IdentityRef Gets the identity who modified.
name string Gets name of release.
reason ReleaseReason Gets reason for release.
releaseDefinition ReleaseDefinitionShallowReference Gets release definition shallow reference.
url string
webAccessUri string

ReleaseRevision

Field Type
changedBy IdentityRef
changedDate date-time
changeDetails string
changeType string
comment string
definitionSnapshotRevision int32
releaseId int32

ReleaseSchedule

Field Type Notes
daysToRelease ScheduleDays Days of the week to release
jobId GUID Team Foundation Job Definition Job Id
startHours int32 Local time zone hour to start
startMinutes int32 Local time zone minute to start
timeZoneId string Time zone Id of release schedule, such as 'UTC'

ReleaseSettings

Field Type
retentionSettings RetentionSettings

ReleaseShallowReference

Field Type Notes
_links ReferenceLinks Gets the links to related resources, APIs, and views for the release.
id int32 Gets the unique identifier of release.
name string Gets or sets the name of the release.
url string Gets the REST API url to access the release.

ReleaseStartMetadata

Field Type Notes
artifacts array (ArtifactMetadata) Sets list of artifact to create a release.
definitionId int32 Sets definition Id to create a release.
description string Sets description to create a release.
isDraft boolean Sets 'true' to create release in draft mode, 'false' otherwise.
manualEnvironments array (string) Sets list of environments to manual as condition.
properties PropertiesCollection
reason ReleaseReason Sets reason to create a release.

ReleaseStatus

Enum Value Notes
undefined
draft
active
abandoned

ReleaseTask

Field Type
agentName string
dateEnded date-time
dateStarted date-time
finishTime date-time
id int32
issues array (Issue)
lineCount int64
logUrl string
name string
percentComplete int32
rank int32
startTime date-time
status TaskStatus
task WorkflowTaskReference
timelineRecordId GUID

ReleaseTaskLogUpdatedEvent

Extends: RealtimeReleaseEvent

Field Type
environmentId int32
lines array (string)
timelineRecordId GUID

ReleaseTasksUpdatedEvent

Extends: RealtimeReleaseEvent

Field Type
environmentId int32
job ReleaseTask
releaseDeployPhaseId int32
releaseStepId int32
tasks array (ReleaseTask)

ReleaseTriggerBase

Field Type
triggerType ReleaseTriggerType

ReleaseTriggerType

Enum Value Notes
undefined
artifactSource
schedule
sourceRepo

ReleaseUpdatedEvent

Extends: RealtimeReleaseEvent

Field Type
release Release

ReleaseUpdateMetadata

Field Type Notes
comment string Sets comment for release.
keepForever boolean Set 'true' to exclude the release from retention policies.
manualEnvironments array (string) Sets list of manual environments.
status ReleaseStatus Sets status of the release.

ReleaseWorkItemRef

Field Type
id string
url string

RetentionPolicy

Field Type
daysToKeep int32

RetentionSettings

Field Type
daysToKeepDeletedReleases int32
defaultEnvironmentRetentionPolicy EnvironmentRetentionPolicy
maximumEnvironmentRetentionPolicy EnvironmentRetentionPolicy

RunOnServerDeployPhase

Extends: DeployPhase

Field Type
deploymentInput ServerDeploymentInput

ScheduleDays

Enum Value Notes
none
monday
tuesday
wednesday
thursday
friday
saturday
sunday
all

ScheduledReleaseTrigger

Extends: ReleaseTriggerBase

Field Type Notes
schedule ReleaseSchedule Release schedule for Scheduled Release trigger type

SenderType

Enum Value Notes
serviceAccount
requestingUser

ServerDeploymentInput

Extends: BaseDeploymentInput

Field Type
parallelExecution ExecutionInput

SourceIdInput

Field Type
id string
name string

SourceRepoTrigger

Extends: ReleaseTriggerBase

Field Type
alias string
branchFilters array (string)

SummaryMailSection

Field Type
htmlContent string
rank int32
sectionType MailSectionType
title string

TaskInputDefinitionBase

Field Type
defaultValue string
groupName string
helpMarkDown string
label string
name string
options dictionary (string, string)
properties dictionary (string, string)
required boolean
type string
visibleRule string

TaskOrchestrationPlanGroupReference

Field Type
planGroup string
projectId GUID

TaskOrchestrationPlanGroupsStartedEvent

Field Type
planGroups array (TaskOrchestrationPlanGroupReference)

TaskSourceDefinitionBase

Field Type
authKey string
endpoint string
keySelector string
selector string
target string

TaskStatus

Enum Value Notes
unknown
pending
inProgress
success
failure
canceled
skipped
succeeded
failed
partiallySucceeded

TimeZone

Field Type
displayName string
id string

TimeZoneList

Field Type
utcTimeZone TimeZone
validTimeZones array (TimeZone)

VariableGroup

Field Type Notes
createdBy IdentityRef Gets or sets the identity who created.
createdOn date-time Gets date on which it got created.
description string Gets or sets description.
id int32 Gets the unique identifier of this field.
modifiedBy IdentityRef Gets or sets the identity who modified.
modifiedOn date-time Gets date on which it got modified.
name string Gets or sets name.
providerData VariableGroupProviderData Gets or sets provider data.
type string Gets or sets type.
variables dictionary (string, VariableValue)

VariableGroupActionFilter

Enum Value Notes
none
manage
use

VariableGroupProviderData

VariableValue

Field Type
isSecret boolean
value string

VssJsonCollectionWrapper<T>

This class is used to serialized collections as a single JSON object on the wire, to avoid serializing JSON arrays directly to the client, which can be a security hole

Extends: VssJsonCollectionWrapperBase

Field Type
value T

VssJsonCollectionWrapperBase

Field Type
count int32

WorkflowTask

Field Type
alwaysRun boolean
condition string
continueOnError boolean
definitionType string
enabled boolean
inputs dictionary (string, string)
name string
overrideInputs dictionary (string, string)
refName string
taskId GUID
timeoutInMinutes int32
version string

WorkflowTaskReference

Field Type
id GUID
name string
version string