Skip to main content
POST
/
projects
/
{project_id}
/
tasks
Create Task
curl --request POST \
  --url https://api.everhour.com/projects/{project_id}/tasks \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "name": "Task Name",
  "section": 1234,
  "labels": [
    "high",
    "bug"
  ],
  "position": 1,
  "description": "<string>",
  "dueOn": "2018-03-05",
  "status": "open"
}
'
{
  "id": "ev:9876543210",
  "name": "Task Name",
  "projects": [
    "ev:1234567890"
  ],
  "section": 1234,
  "labels": [
    "high",
    "bug"
  ],
  "position": 1,
  "description": "<string>",
  "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
  },
  "unbillable": true
}

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
project_id
string
required

Project ID

Example:

"ev:1234567789001"

Body

application/json
​
name
string
required
Example:

"Task Name"

​
section
number
required

Section ID

Example:

1234

​
labels
string[]
Example:
["high", "bug"]
​
position
number
Example:

1

​
description
string
​
dueOn
string

Format: Y-m-d

Example:

"2018-03-05"

​
status
enum<string>
Available options:
open,
closed
Example:

"open"

Response

Created

​
id
string
required
Example:

"ev:9876543210"

​
name
string
required
Example:

"Task Name"

​
projects
string[]
required

List of projects ID

Example:
["ev:1234567890"]
​
section
number | null

Section ID

Example:

1234

​
labels
string[]
Example:
["high", "bug"]
​
position
number
Example:

1

​
description
string | null
​
dueAt
string | null

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

Example:

"2018-03-05 16:00:00"

​
status
enum<string>
Available options:
open,
closed
Example:

"open"

​
time
object
​
estimate
object
​
attributes
object

Custom attributes from integration

Example:
{ "Client": "Everhour", "Priority": "high" }
​
metrics
object

Custom metrics from integration

Example:
{ "efforts": 42, "expenses": 199 }
​
unbillable
boolean