Adds a new agile task to QAComplete.
Use the operation to register a new agile task in your project in QAComplete.
To replace the entire agile task (to redefine all the field values), use the …/agiletasks/{Id} (PUT) operation. To update individual fields, use the …/agiletasks/{Id} (PATCH) operation.
Authentication
Basic authentication using a user’s login and password. See Authentication for details.
Security Rights
The authenticating user must belong to a security group that has the Add privilege for Agile Tasks.
Request Format
To create an agile task, send a POST request to the following URL:
URL parameters
ProjectId : integer, required
The ID of the project to which you want to add a agile task.
Body parameters
In the request body, pass the RequestProjectTaskPost object that describes the agile task to create.
"Title": "string",
"PctComplete": "int",
"EstHrs": "double",
"ActualHrs": "double",
"EstCost": "double",
"ActualCost": "double",
"RequestedBy": "string",
"OwnerUserId": "int",
"AssigneeUserId": "int",
"PriorityCode": "string",
"StatusCode": "string",
"Grouping": "string",
"SubGrouping": "string",
"Keywords": "string",
"SortOrder": "int",
"Description": "string",
"OriginalId": "int",
"ImportId": "int",
"FolderId": "int",
"EstStart": "Date",
"EstFinish": "Date",
"ActStart": "Date",
"ActFinish": "Date",
"EstHrsRemaining": "double",
"ActHrs": "double",
"CustomFields": [
{
"Id": "string",
"Name": "string",
"Value": "string"
}
]
}
Some string property values (for example, StatusCode) are based on the choice lists defined in your QAComplete project. To view these values, go to the Agile Tasks > Actions > Manage Choice Lists screen in QAComplete.
Title : string (max 255 chars), required
The title of the agile task. Cannot be empty.
PctComplete : integer
Percentage of the agile task’s completion.
EstHrs : double
Estimated hours required to complete the agile task.
ActualHrs : double
Actual hours spent working on the agile task.
EstCost : double
The estimated cost of working on the agile task.
ActualCost : double
The actual cost of working on the agile task.
RequestedBy : string
The name of the user who requested the agile task, in the Last name, First name format.
OwnerUserId : integer
The ID of the user who owns the agile task.
AssigneeUserId : integer
The ID of the user to whom the agile task is assigned.
PriorityCode : string
The priority of the agile task.
StatusCode : string
The status code of the agile task.
Grouping : string
The mechanism of task grouping.
SubGrouping : string
The mechanism of task grouping.
Keywords : string
The list of keywords for searching purposes.
SortOrder : integer
The ordinal number of the agile task specified in the project.
Description : string
The description of the agile task.
OriginalId : integer
The original ID of the agile task, as it was specified in the external file from which it was import.
ImportId : integer
The ID of the operation that imported the agile task from an external file.
FolderId : integer
The ID of the folder to which the agile task belongs.
EstStart : dateTime
Estimated date and time when work on the agile task should begin.
EstFinish : dateTime
Estimated date and time when work on the agile task should finish.
ActStart : dateTime
Actual date when work on the agile task was started.
ActFinish : dateTime
Actual date when work on the agile task was finished.
EstHrsRemaining : double, required
Estimated number of hours required to finish the agile task.
ActHrs : double
Actual hours spent working on the agile task..
CustomFields : array of objects
An array of CustomFields objects that describe custom fields and their values:
{
"Id": "string",
"Name": "string",
"Value": "string"
}
Id : string, required
The unique identifier of the custom field. Must be in the CustomN format, where N is the custom field’s number (index).
Name : string
The field name.
Value : string
The field value.
A sample request:
POST http://yourserver.com/rest-api/service/api/v2/projects/11873/agiletasks HTTP/1.1
Host: yourserver.com
Connection: keep-alive
Content-Type: application/json
Accept: application/json
Authorization: Basic am9obkBleGFtcGxlLmNvbTpwQHNzd29yZA==
Content-Length: 35
{
"Title": "Sample agile task",
}
A sample request made by using cURL:
curl -u [email protected]:p@ssword -d {"Title": "Sample agile task"} -H "Content-Type: application/json" -H "Accept: application/json" http://yourserver.com/rest-api/service/api/v2/projects/11873/agile tasks
Response Format
On success, the operation responds with HTTP status code 200. The response is a JSON object with information on the added agile task.
A sample response:
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 762
{
"project_id": 11873,
"id": 805662,
"task_type_code": "ProjectTasks",
"title": "Sample agile task",
"pct_complete": 0,
"est_hrs": 0,
"owner_user_id": 146537,
"assignee_user_id": 0,
"status_code": "Active",
"folder_id": 0,
"est_start": "0001-01-01T00:00:00.0000000",
"est_finish": "0001-01-01T00:00:00.0000000",
"act_start": "0001-01-01T00:00:00.0000000",
"act_finish": "0001-01-01T00:00:00.0000000",
"est_hrs_remaining": 0,
"act_hrs": 0,
"update_user_id": 146537,
"date_created": "2019-07-08T08:27:26.7500000",
"date_updated": "2019-07-08T08:27:26.7500000",
"user_name": "Smith, John ",
"owner_name": "Smith, John ",
"event_type": "Project Task",
"nbr_files": 0,
"nbr_notes": 0,
"nbr_events": 0,
"nbr_escalations": 0,
"last_escalation_rule": "",
"custom_fields": [],
"__permissions": {
"acl": 7
}
}
The authenticating user’s rights to access the agile tasks.
Access rights:
- 0 - None
- 1 - Read
- 2 - Update
- 3 - Read and update
- 4 - Delete
- 5 - Read and delete
- 7 - Full access
An array of agile tasks.
The ID of the QAComplete project that contains the agile task.
The unique identifier of the agile task.
A string that represents a type code of the task.
The user-friendly name (title) of the agile task.
The percentage complete of the agile task’s implementation.
The estimated hours to implement the agile task.
The ID of the user who owns the agile task.
The ID of the user to whom the agile task is assigned. 0 if the agile task is not assigned to anyone.
The agile task’s status code.
The ordinal number of the agile task specified in the project.
The ID of the folder containing the agile task, or 0 if the agile task is not in any folder.
The estimated start date for the agile task.
The estimated finish date for the agile task.
The actual start date of the agile task.
The actual date when the agile task was implemented.
The estimated remaining hours to implement the agile task.
The actual hours spent implementing the agile task.
The ID of the user who updated the agile task last time.
The date and time when the agile task was created.
The date and time when the agile task was last updated.
The name of the user who last updated the agile task, in the LastName, FirstName format.
The name of the user who owns the agile task, in the Lastname, Firstname format.
The event type of the agile task.
The number of files attached to the agile task.
The number of notes attached to the agile task.
The number of calendar events attached to the agile task.
The number of times the agile task was processed by escalation rules.
The date when the agile task was last processed by an escalation rule.
The ID of the escalation rule that processed the agile task last. 0 if no escalation rule processed the agile task.
The name of the escalation rule that processed the agile task last.
An array of objects that describe custom fields and their values.
Error responses
If the operation fails, it returns the appropriate status code and (optionally) the error description in the response body.
If the project with the specified ProjectId does not exist or the authenticating user does not have rights to access the project, the operation returns the Access is denied error.
If does not exist, the operation returns the File or directory not found error.