POST: projects/{project_id}/tasks

Description

Creates a new task in the system

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}/tasks

Request Parameters

Name	Description
project_id	The id of the current project

Request Body

Property	Description
TaskId	The id of the task
TaskStatusId	The id of the status of the task
RequirementId	The id of the parent requirement that the task belongs to
ReleaseId	The id of the release/iteration that the task is scheduled for
CreatorId	The id of the user that originally created the task If no value is provided, the authenticated user is used instead
OwnerId	The id of the user that the task is assigned-to
TaskPriorityId	The id of the priority of the task
Name	The name of the task
Description	The detailed description of the task
CreationDate	The date/time that the task was originally created
LastUpdateDate	The date/time that the task was last modified This field needs to match the values retrieved to ensure data-concurrency
StartDate	The scheduled start date for the task
EndDate	The scheduled end date for the task
CompletionPercent	The completion percentage (value = 0-100) of the task as calculated in the system from the remaining effort vs. the original estimated effort. Read-Only
EstimatedEffort	The originally estimated effort (in minutes) of the task
ActualEffort	The actual effort expended so far (in minutes) for the task
RemainingEffort	The effort remaining as reported by the developer
ProjectedEffort	The projected actual effort of the task when it is completed Read-Only
TaskStatusName	The display name of the status of the task
OwnerName	The display name of the user who the task is assigned-to Read-Only
TaskPriorityName	The display name of the priority of the task Read-Only
ProjectName	The display name of the project the task belongs to Read-Only
ReleaseVersionNumber	The version number of the release/iteration the task is scheduled for Read-Only
RequirementName	The name of the requirement that the task is associated with Read-Only
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

                    <RemoteTask 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" />
  <ActualEffort i:nil="true" />
  <CompletionPercent>0</CompletionPercent>
  <CreationDate>0001-01-01T00:00:00</CreationDate>
  <CreatorId i:nil="true" />
  <Description i:nil="true" />
  <EndDate i:nil="true" />
  <EstimatedEffort i:nil="true" />
  <LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
  <Name i:nil="true" />
  <OwnerId i:nil="true" />
  <OwnerName i:nil="true" />
  <ProjectName i:nil="true" />
  <ProjectedEffort i:nil="true" />
  <ReleaseId i:nil="true" />
  <ReleaseVersionNumber i:nil="true" />
  <RemainingEffort i:nil="true" />
  <RequirementId i:nil="true" />
  <RequirementName i:nil="true" />
  <StartDate i:nil="true" />
  <TaskId i:nil="true" />
  <TaskPriorityId i:nil="true" />
  <TaskPriorityName i:nil="true" />
  <TaskStatusId>0</TaskStatusId>
  <TaskStatusName i:nil="true" />
</RemoteTask>

                    {"ArtifactTypeId":0,
"ConcurrencyDate":"\/Date(-62135578800000-0500)\/",
"CustomProperties":null,
"ProjectId":null,
"ActualEffort":null,
"CompletionPercent":0,
"CreationDate":"\/Date(-62135578800000-0500)\/",
"CreatorId":null,
"Description":null,
"EndDate":null,
"EstimatedEffort":null,
"LastUpdateDate":"\/Date(-62135578800000-0500)\/",
"Name":null,
"OwnerId":null,
"OwnerName":null,
"ProjectName":null,
"ProjectedEffort":null,
"ReleaseId":null,
"ReleaseVersionNumber":null,
"RemainingEffort":null,
"RequirementId":null,
"RequirementName":null,
"StartDate":null,
"TaskId":null,
"TaskPriorityId":null,
"TaskPriorityName":null,
"TaskStatusId":0,
"TaskStatusName":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
TaskId	The id of the task
TaskStatusId	The id of the status of the task
RequirementId	The id of the parent requirement that the task belongs to
ReleaseId	The id of the release/iteration that the task is scheduled for
CreatorId	The id of the user that originally created the task If no value is provided, the authenticated user is used instead
OwnerId	The id of the user that the task is assigned-to
TaskPriorityId	The id of the priority of the task
Name	The name of the task
Description	The detailed description of the task
CreationDate	The date/time that the task was originally created
LastUpdateDate	The date/time that the task was last modified This field needs to match the values retrieved to ensure data-concurrency
StartDate	The scheduled start date for the task
EndDate	The scheduled end date for the task
CompletionPercent	The completion percentage (value = 0-100) of the task as calculated in the system from the remaining effort vs. the original estimated effort. Read-Only
EstimatedEffort	The originally estimated effort (in minutes) of the task
ActualEffort	The actual effort expended so far (in minutes) for the task
RemainingEffort	The effort remaining as reported by the developer
ProjectedEffort	The projected actual effort of the task when it is completed Read-Only
TaskStatusName	The display name of the status of the task
OwnerName	The display name of the user who the task is assigned-to Read-Only
TaskPriorityName	The display name of the priority of the task Read-Only
ProjectName	The display name of the project the task belongs to Read-Only
ReleaseVersionNumber	The version number of the release/iteration the task is scheduled for Read-Only
RequirementName	The name of the requirement that the task is associated with Read-Only
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

<RemoteTask 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" />
  <ActualEffort i:nil="true" />
  <CompletionPercent>0</CompletionPercent>
  <CreationDate>0001-01-01T00:00:00</CreationDate>
  <CreatorId i:nil="true" />
  <Description i:nil="true" />
  <EndDate i:nil="true" />
  <EstimatedEffort i:nil="true" />
  <LastUpdateDate>0001-01-01T00:00:00</LastUpdateDate>
  <Name i:nil="true" />
  <OwnerId i:nil="true" />
  <OwnerName i:nil="true" />
  <ProjectName i:nil="true" />
  <ProjectedEffort i:nil="true" />
  <ReleaseId i:nil="true" />
  <ReleaseVersionNumber i:nil="true" />
  <RemainingEffort i:nil="true" />
  <RequirementId i:nil="true" />
  <RequirementName i:nil="true" />
  <StartDate i:nil="true" />
  <TaskId i:nil="true" />
  <TaskPriorityId i:nil="true" />
  <TaskPriorityName i:nil="true" />
  <TaskStatusId>0</TaskStatusId>
  <TaskStatusName i:nil="true" />
</RemoteTask>

{"ArtifactTypeId":0,
"ConcurrencyDate":"\/Date(-62135578800000-0500)\/",
"CustomProperties":null,
"ProjectId":null,
"ActualEffort":null,
"CompletionPercent":0,
"CreationDate":"\/Date(-62135578800000-0500)\/",
"CreatorId":null,
"Description":null,
"EndDate":null,
"EstimatedEffort":null,
"LastUpdateDate":"\/Date(-62135578800000-0500)\/",
"Name":null,
"OwnerId":null,
"OwnerName":null,
"ProjectName":null,
"ProjectedEffort":null,
"ReleaseId":null,
"ReleaseVersionNumber":null,
"RemainingEffort":null,
"RequirementId":null,
"RequirementName":null,
"StartDate":null,
"TaskId":null,
"TaskPriorityId":null,
"TaskPriorityName":null,
"TaskStatusId":0,
"TaskStatusName":null}����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������