{"_id":"554a8077d665ae0d00383f75","__v":8,"user":"55484649b2581a0d00913ff3","category":{"_id":"554a7f3338e3620d0082192e","version":"5548466bd2c8410d006c2146","project":"5548466bd2c8410d006c2143","__v":5,"pages":["554a7f3d6b448d0d00646b97","554a7f5e6b448d0d00646b99","554a7fa0d665ae0d00383f65","554a8077d665ae0d00383f75","554a8088d665ae0d00383f77"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-05-06T20:53:07.204Z","from_sync":false,"order":2,"slug":"tasks","title":"Tasks"},"project":"5548466bd2c8410d006c2143","editedParams":true,"editedParams2":true,"version":{"_id":"5548466bd2c8410d006c2146","project":"5548466bd2c8410d006c2143","__v":8,"createdAt":"2015-05-05T04:26:19.796Z","releaseDate":"2015-05-05T04:26:19.796Z","categories":["5548466cd2c8410d006c2147","554a69ba0b54d30d007fe128","554a7f3338e3620d0082192e","5565162e03b6710d00916942","55651a0c65a1130d00400c2b","55651d4565a1130d00400c2f","55651e0165a1130d00400c32","5565217903b6710d0091695f"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-05-06T20:58:31.642Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"javascript","code":"var data = {\n\t\tprojectId: projectId,\n\t\tname: \"test api task1\",\n\t\tnotes: \"api notes\",\n\t\tstart: \"2015-04-13T00:00:00\",\n\t\tfinish: \"2015-05-13T00:00:00\",\n\t\tduration: 2400,\n    customColumns:\n      [\n        { name: \"MyCurrencyCol\", type: \"currency\", data: \"95.99\", extendedColumnId=567},\n        { name: \"MyNumberCol\", type: \"number\", data: \"1234\", extendedColumnId=568},\n        { name: \"MyDateCol\", type: \"currency\", data: \"27-01-2018\", extendedColumnId=569},\n        { name: \"MyStringCol\", type: \"string\", data: \"Spiffy Sprockets\", extendedColumnId=570},\n        { name: \"MyBoolCol\", type: \"bool\", data: \"true\", extendedColumnId=571}\n      ]\n}\n\n$.ajax({\n\t \ttype: \"POST\", \n   \turl: \"/api/v1/tasks.json\", \n   \tcontentType: 'application/json', \n   \tdataType: \"json\", \n   \tsuccess: worked,\n   \tdata: JSON.stringify(data), \n   \theaders: { apiKey: apiKey }\n });"}]},"method":"post","results":{"codes":[{"status":200,"name":"","code":"{\n    status: \"Okay\",\n    task: {\n        projectId: 123456,\n        name: \"test api task1\",\n        notes: \"api notes\",\n        start: \"2015-04-13T00:00:00\",\n        finish: \"2015-05-13T00:00:00\",\n        duration: 2400,\n        customColumns:\n          [\n            { name: \"MyCurrencyCol\", type: \"currency\", data: \"95.99\", extendedColumnId=567},\n            { name: \"MyNumberCol\", type: \"number\", data: \"1234\", extendedColumnId=568},\n            { name: \"MyDateCol\", type: \"currency\", data: \"27-01-2018\", extendedColumnId=569},\n            { name: \"MyStringCol\", type: \"string\", data: \"Spiffy Sprockets\", extendedColumnId=570},\n            { name: \"MyBoolCol\", type: \"bool\", data: \"true\", extendedColumnId=571}\n          ]\n    }\n}","language":"json"}]},"settings":"","auth":"required","params":[{"_id":"5565159803b6710d0091693d","ref":"","in":"body","required":true,"desc":"The name of your task.","default":"","type":"string","name":"name"},{"_id":"5565159803b6710d0091693c","ref":"","in":"body","required":true,"desc":"The project your task belongs to.","default":"","type":"int","name":"projectId"},{"_id":"5565159803b6710d0091693b","ref":"","in":"body","required":false,"desc":"Task start date. yyyy-mm-ddT00:00:00","default":"","type":"datetime","name":"start"},{"_id":"5565159803b6710d0091693a","ref":"","in":"body","required":false,"desc":"Task finish date. yyyy-mm-ddT00:00:00","default":"","type":"datetime","name":"finish"},{"_id":"5565159803b6710d00916939","ref":"","in":"body","required":false,"desc":"The duration of the task, in minutes.","default":"0","type":"int","name":"duration"},{"_id":"5565159803b6710d00916938","ref":"","in":"body","required":false,"desc":"List<int>, The list of the resource ids to assign to the given task.","default":"null","type":"int","name":"assignments"},{"_id":"5589e6d986780e1700e44617","ref":"","in":"body","required":false,"desc":"The notes for the task.","default":"","type":"string","name":"notes"},{"_id":"58d9a7e255a5c10f00836c0a","ref":"","in":"body","required":false,"desc":"Task-level custom columns and their value. (Note: the column must have been previously created for the project before you can post it here)","default":"","type":"array_object","name":"customColumns"}],"url":"/tasks.json"},"isReference":false,"order":2,"body":"Use this API to create a new task for a given project.\n\nReturns the simple task object that was passed in.","excerpt":"A Task instance represents a task created within a Project. It may be a high level summary task, or a task within a task. \n\nUse this API to create a Task against a particular project.","slug":"create-a-task","type":"endpoint","title":"Create A Task"}

postCreate A Task

A Task instance represents a task created within a Project. It may be a high level summary task, or a task within a task. Use this API to create a Task against a particular project.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

name:
required
string
The name of your task.
projectId:
required
integer
The project your task belongs to.
start:
datetime
Task start date. yyyy-mm-ddT00:00:00
finish:
datetime
Task finish date. yyyy-mm-ddT00:00:00
duration:
integer0
The duration of the task, in minutes.
assignments:
integernull
List<int>, The list of the resource ids to assign to the given task.
notes:
string
The notes for the task.
customColumns:
array of objects
Task-level custom columns and their value. (Note: the column must have been previously created for the project before you can post it here)

Examples


Result Format


Documentation

Use this API to create a new task for a given project. Returns the simple task object that was passed in.