Sign in

v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB
Tasks

Create Task

Create a task in a project. For tasks coming from connected integrations, sync them via POST /projects/{project_id}/sync instead.

post/projects/{project_id}/tasks

Path parameters

project_idstring required
Example:ev:1234567789001

Project ID

Request body

namestring required
sectioninteger

Section ID

labelsstring[]
status'open' | 'closed'
colorstring

Label color, max 15 chars.

dueOnstring

Due date, format Y-m-d. Send "" to clear.

startOnstring

Start date, format Y-m-d. Send "" to clear.

descriptionstring

Plain-text description, max 2000 chars.

tagsinteger[]

Tag IDs, max 10.

fieldsobject[]

Custom field values.

placeBeforestring[]

Encoded IDs of tasks to place this one before (create only).

Example request

{
  "name": "Task Name",
  "section": 1234,
  "labels": [
    "high",
    "bug"
  ],
  "status": "open",
  "color": "#fdb301",
  "dueOn": "2018-03-05",
  "startOn": "2018-03-01",
  "cover": {
    "coverPick": "recent"
  }
}

Response

Created

idstring required
namestring required
projectsstring[] required

List of projects ID

sectionnumber nullable

Section ID

labelsstring[]
positionnumber
descriptionstring nullable
dueAtstring nullable

Format: Y-m-d H:i:s

status'open' | 'closed'
attributesobject

Custom attributes from integration

metricsobject

Custom metrics from integration

unbillableboolean

Example response

{
  "id": "ev:9876543210",
  "name": "Task Name",
  "projects": [
    "ev:1234567890"
  ],
  "section": 1234,
  "labels": [
    "high",
    "bug"
  ],
  "position": 1,
  "dueAt": "2018-03-05 16:00:00",
  "status": "open",
  "time": {
    "total": 7200,
    "users": {
      "1304": 3600,
      "1543": 3600
    }
  },
  "estimate": {
    "total": 7200,
    "type": "overall",
    "users": {
      "1304": 3600,
      "1543": 3600
    }
  },
  "attributes": {
    "Client": "Everhour",
    "Priority": "high"
  },
  "metrics": {
    "efforts": 42,
    "expenses": 199
  }
}