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/v6_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)

<RemoteTaskFolder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v6_0.DataObjects">
  <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}

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)

<RemoteTaskFolder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Inflectra.SpiraTest.Web.Services.v6_0.DataObjects">
  <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}