Knowledge base - Creating a task through API: post

Sample post_task request

?action=post_task&id_project=PROJECT_ID&title=TASK_NAME

Creates (sub)task in selected project
*allows files attaching to (sub)task description (see details)

Required parameters:

id_project — project ID

title — task name

Optional parameters:

id_parent — parent task ID (creating subtask)
email_user_from — task author email (will be set automatically if using access token)
email_user_to — task executive email, additional possible values: ANY – "Anyone", NOONE or not specified – "Executive isn't assigned"
priority — priority (value range: 0..10)
text — task description
todo⦋⦌ — checkbox item added to task description (combine several items to get checklist, example: todo⦋⦌=case1&todo⦋⦌=case2)
datestart — start date in DD.MM.YYYY format
dateend — due date in DD.MM.YYYY format
subscribe — user emails separated by commas, who will be subscribed to the task
hidden — user emails separated by commas, who will have access to this task, while it will be hidden for others
mention — user emails separated by commas, who will be mentioned at the end of the task description
max_time — time estimates
max_money — financial estimates
tags — task tags separated by commas (for example: tags=TAG1,TAG2)
Tag names (if unique) or their IDs (available via get_task_tags method) are supported. Only tags from sets added to the project are allowed

Sample JSON response

If the request succeeds, the response will contain ok status and the following data:

{
    "status": "ok",
    "data": {
        "id": "TASK_ID",
        "name": "TASK_NAME",
        "page": "/project/PROJECT_ID/TASK_ID/",
        "status": "active",
        "priority": "0..10",
        "user_from": {
            "id": "USER_ID",  
            "email": "USER_EMAIL",
            "name": "USER_NAME"
        },
        "user_to": {
            "id": "USER_ID",
            "email": "USER_EMAIL",
            "name": "USER_NAME"
        },
        "project": {
            "id": "PROJECT_ID",
            "name": "PROJECT_NAME",
            "page": "/project/PROJECT_ID/"
        },
        "text": "TASK_TEXT",
        "date_added": "YYYY—MM—DD HH:II",
        "date_start": "YYYY—MM—DD",
        "date_end": "YYYY—MM—DD",
        "max_time": 40,
        "max_money": 200,
        "tags": {
            "TAG_ID": "TAG_NAME_1",
            "TAG_ID": "TAG_NAME_2",

        }
    }
}

Creating a task through API: post_task