Creating tasks
This endpoint creates a new task.
HTTP Request​
POST https://api.lunatask.app/v1/tasks
Body Parameters​
Parameter | Description |
---|---|
area_id | The Area ID of the list where the task should be created (UUID, can be found in our apps in the area settings) |
name | The name of the task (optional, but impractical if empty) |
note | The note attached to task (optional, formatted in Markdown) |
status | The status of the task (optional, see possible values) |
motivation | The motivation value of the task (optional, see possible values) |
eisenhower | The quadrant on Eisenhower matrix (optional, see possible values) |
estimate | The estimate of the task (optional, in minutes) |
priority | Priority of the task (optional, see possible values) |
scheduled_on | ISO-8601 formatted date the task is scheduled on (optional) |
completed_at | ISO-8601 formatted time when the task was completed (optional) |
source | Identification of external system where the task is coming from (optional, e.g. "github" ) |
source_id | The ID of the record in the external system (optional, e.g. "123" ) |
source
/source_id
attributes are useful for later lookup of previously created tasks when updating without a need to remember task IDs. The API does not enforce uniqueness of source
/source_id
.
When creating a task, given there's already an existing not completed task in the same area with the same source
/source_id
, the endpoint will return 204 No Content
without creating a duplicate.
Example in Ruby​
require 'rest-client'
RestClient.post('https://api.lunatask.app/v1/tasks', { name: 'My task', source: 'github', source_id: '123', area_id: '11b37775-5a34-41bb-b109-f0e5a6084799' }.to_json, { Authorization: "bearer #{access_token}", "Content-Type": 'application/json' })
Response​
The above command returns JSON structured like this:
{
"task": {
"id": "066b5835-184f-4fd9-be60-7d735aa94708",
"area_id": "11b37775-5a34-41bb-b109-f0e5a6084799",
"status": "later",
"previous_status": null,
"estimate": null,
"priority": 0,
"motivation": "unknown",
"eisenhower": 0,
"sources": [
{
"source": "github",
"source_id": "123"
}
],
"scheduled_on": null,
"completed_at": null,
"created_at": "2021-01-10T10:39:25Z",
"updated_at": "2021-01-10T10:39:25Z",
"deleted_at": null
}
}