See all operations
POST: projects/{project_id}/task-folders
Description
Creates a new task folder in the system
How to Execute
To access this REST web service, you need to use the following URL (make sure to replace any parameters (eg {project_id}) with the relevant value (eg 1):
https://api.inflectra.com/spira/services/v7_0/RestService.svc/projects/{project_id}/task-folders
Request Parameters
|
Name
|
Description
|
|
project_id
|
The id of the current project
|
Request Body
|
Property
|
Description
|
|
TaskFolderId
|
The id of the task folder
|
|
ProjectId
|
The id of the project this folder belongs to
|
|
Name
|
The name of the task folder
|
|
ParentTaskFolderId
|
The ID of the parent folder of this folder (if any)
|
|
Guid
|
The unique identifier for the artifact
|
|
ConcurrencyGuid
|
GUID for representing the concurrency state of a given artifact
|
|
LastUpdateDate
|
Last time the artifact was updated
|
<RemoteTaskFolder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<ConcurrencyGuid i:nil="true" />
<Guid i:nil="true" />
<LastUpdateDate i:nil="true" />
<IndentLevel i:nil="true" />
<Name i:nil="true" />
<ParentTaskFolderId i:nil="true" />
<ProjectId>0</ProjectId>
<TaskFolderId i:nil="true" />
</RemoteTaskFolder>
{"TaskFolderId":null,
"ProjectId":0,
"IndentLevel":null,
"Name":null,
"ParentTaskFolderId":null,
"Guid":null,
"ConcurrencyGuid":null,
"LastUpdateDate":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
|
|
TaskFolderId
|
The id of the task folder
|
|
ProjectId
|
The id of the project this folder belongs to
|
|
IndentLevel
|
The indentation level of the folder
The system uses a set of three-letter segments to denote indent (e.g. AAA followed by AAB, etc.)
|
|
Name
|
The name of the task folder
|
|
ParentTaskFolderId
|
The ID of the parent folder of this folder (if any)
|
|
Guid
|
The unique identifier for the artifact
|
|
ConcurrencyGuid
|
GUID for representing the concurrency state of a given artifact
|
|
LastUpdateDate
|
Last time the artifact was updated
|
<RemoteTaskFolder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v7_0.DataObjects">
<ConcurrencyGuid i:nil="true" />
<Guid i:nil="true" />
<LastUpdateDate i:nil="true" />
<IndentLevel i:nil="true" />
<Name i:nil="true" />
<ParentTaskFolderId i:nil="true" />
<ProjectId>0</ProjectId>
<TaskFolderId i:nil="true" />
</RemoteTaskFolder>
{"TaskFolderId":null,
"ProjectId":0,
"IndentLevel":null,
"Name":null,
"ParentTaskFolderId":null,
"Guid":null,
"ConcurrencyGuid":null,
"LastUpdateDate":null}