POST: projects/{project_id}/releases

Description

Creates a new release in the system at the root level

How to Execute

To access this REST web service, you need to use the following URL:

https://api.inflectra.com/Spira/Services/v4_0/RestService.svc/projects/{project_id}/releases

Request Parameters

Name	Description
project_id	The id of the current project

Request Body

Property	Description
ReleaseId	The id of the release
CreatorId	The id of the user that created the release
IndentLevel	The indentation level of the artifact The system uses a set of three-letter segments to denote indent (e.g. AAA followed by AAB, etc.)
Name	The name of the release
Description	The description of the release
VersionNumber	The version number string of the release
CreationDate	The date the release was originally created
LastUpdateDate	The date the release was last modified
Summary	Is this release a summary one (i.e. does it have child releases)
Active	Is this release active for the project
Iteration	Is this an iteration (true) or a release (false)
StartDate	What is the start date for the release
EndDate	What is the end date for the release
ResourceCount	How many people are working on the release
DaysNonWorking	How many non-working days are associated with the release
PlannedEffort	What is the estimated planned effort associated with the release
AvailableEffort	How much effort is still available in the release for planning
TaskEstimatedEffort	How much effort was estimated for all the tasks scheduled for this release
TaskActualEffort	How much effort was actually expended for all the tasks scheduled for this release
TaskCount	How many tasks are scheduled for this release
CreatorName	What is the full display name of the person who created this release
FullName	The full name and version number of the release combined
ProjectId	The id of the project that the artifact belongs to The current project is always used for Insert operations for security reasons
ArtifactTypeId	The type of artifact that we have (read-only)
ConcurrencyDate	The datetime used to track optimistic concurrency to prevent edit conflicts
CustomProperties	The list of associated custom properties/fields for this artifact

                    <RemoteRelease xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v4_0.DataObjects">
  <ArtifactTypeId>0</ArtifactTypeId>
  <ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
  <CustomProperties i:nil="true" />
  <ProjectId i:nil="true" />
  <Active>false</Active>
  <AvailableEffort i:nil="true" />
  <CreationDate>0001-01-01T00:00:00</CreationDate>
  <CreatorId i:nil="true" />
  <CreatorName i:nil="true" />
  <DaysNonWorking>0</DaysNonWorking>
  <Description i:nil="true" />
  <EndDate>0001-01-01T00:00:00</EndDate>
  <FullName i:nil="true" />
  <IndentLevel i:nil="true" />
  <Iteration>false</Iteration>
  <LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
  <Name i:nil="true" />
  <PlannedEffort i:nil="true" />
  <ReleaseId i:nil="true" />
  <ResourceCount>0</ResourceCount>
  <StartDate>0001-01-01T00:00:00</StartDate>
  <Summary>false</Summary>
  <TaskActualEffort i:nil="true" />
  <TaskCount i:nil="true" />
  <TaskEstimatedEffort i:nil="true" />
  <VersionNumber i:nil="true" />
</RemoteRelease>

                    {"ArtifactTypeId":0,
"ConcurrencyDate":"\/Date(-62135578800000-0500)\/",
"CustomProperties":null,
"ProjectId":null,
"Active":false,
"AvailableEffort":null,
"CreationDate":"\/Date(-62135578800000-0500)\/",
"CreatorId":null,
"CreatorName":null,
"DaysNonWorking":0,
"Description":null,
"EndDate":"\/Date(-62135578800000-0500)\/",
"FullName":null,
"IndentLevel":null,
"Iteration":false,
"LastUpdateDate":"\/Date(-62135578800000-0500)\/",
"Name":null,
"PlannedEffort":null,
"ReleaseId":null,
"ResourceCount":0,
"StartDate":"\/Date(-62135578800000-0500)\/",
"Summary":false,
"TaskActualEffort":null,
"TaskCount":null,
"TaskEstimatedEffort":null,
"VersionNumber":null}��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������

Return Data

The JSON and XML examples below show the shape of one entry that will be returned. It does not show an example of how that entry will be populated.

Property	Description
ReleaseId	The id of the release
CreatorId	The id of the user that created the release
IndentLevel	The indentation level of the artifact The system uses a set of three-letter segments to denote indent (e.g. AAA followed by AAB, etc.)
Name	The name of the release
Description	The description of the release
VersionNumber	The version number string of the release
CreationDate	The date the release was originally created
LastUpdateDate	The date the release was last modified
Summary	Is this release a summary one (i.e. does it have child releases)
Active	Is this release active for the project
Iteration	Is this an iteration (true) or a release (false)
StartDate	What is the start date for the release
EndDate	What is the end date for the release
ResourceCount	How many people are working on the release
DaysNonWorking	How many non-working days are associated with the release
PlannedEffort	What is the estimated planned effort associated with the release
AvailableEffort	How much effort is still available in the release for planning
TaskEstimatedEffort	How much effort was estimated for all the tasks scheduled for this release
TaskActualEffort	How much effort was actually expended for all the tasks scheduled for this release
TaskCount	How many tasks are scheduled for this release
CreatorName	What is the full display name of the person who created this release
FullName	The full name and version number of the release combined
ProjectId	The id of the project that the artifact belongs to The current project is always used for Insert operations for security reasons
ArtifactTypeId	The type of artifact that we have (read-only)
ConcurrencyDate	The datetime used to track optimistic concurrency to prevent edit conflicts
CustomProperties	The list of associated custom properties/fields for this artifact

<RemoteRelease xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v4_0.DataObjects">
  <ArtifactTypeId>0</ArtifactTypeId>
  <ConcurrencyDate>0001-01-01T00:00:00</ConcurrencyDate>
  <CustomProperties i:nil="true" />
  <ProjectId i:nil="true" />
  <Active>false</Active>
  <AvailableEffort i:nil="true" />
  <CreationDate>0001-01-01T00:00:00</CreationDate>
  <CreatorId i:nil="true" />
  <CreatorName i:nil="true" />
  <DaysNonWorking>0</DaysNonWorking>
  <Description i:nil="true" />
  <EndDate>0001-01-01T00:00:00</EndDate>
  <FullName i:nil="true" />
  <IndentLevel i:nil="true" />
  <Iteration>false</Iteration>
  <LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
  <Name i:nil="true" />
  <PlannedEffort i:nil="true" />
  <ReleaseId i:nil="true" />
  <ResourceCount>0</ResourceCount>
  <StartDate>0001-01-01T00:00:00</StartDate>
  <Summary>false</Summary>
  <TaskActualEffort i:nil="true" />
  <TaskCount i:nil="true" />
  <TaskEstimatedEffort i:nil="true" />
  <VersionNumber i:nil="true" />
</RemoteRelease>

{"ArtifactTypeId":0,
"ConcurrencyDate":"\/Date(-62135578800000-0500)\/",
"CustomProperties":null,
"ProjectId":null,
"Active":false,
"AvailableEffort":null,
"CreationDate":"\/Date(-62135578800000-0500)\/",
"CreatorId":null,
"CreatorName":null,
"DaysNonWorking":0,
"Description":null,
"EndDate":"\/Date(-62135578800000-0500)\/",
"FullName":null,
"IndentLevel":null,
"Iteration":false,
"LastUpdateDate":"\/Date(-62135578800000-0500)\/",
"Name":null,
"PlannedEffort":null,
"ReleaseId":null,
"ResourceCount":0,
"StartDate":"\/Date(-62135578800000-0500)\/",
"Summary":false,
"TaskActualEffort":null,
"TaskCount":null,
"TaskEstimatedEffort":null,
"VersionNumber":null}��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������