Sign in

v1

latestOpenAPI 3.1.1LicenseRef-Proprietary2026-07-1310179223.1 KB
Tasks

Update Task Billing

Set a task's billing rate or mark it non-billable. Requires admin access. The same values are returned on task responses when you pass opts_include_billing=1.

put/tasks/{task_id}/billing

Path parameters

task_idstring required
Example:ev:3000010034

Task ID

Request body

unbillableboolean

Mark the task as non-billable.

rateinteger

Hourly billable rate in cents. Use -1 to leave the current rate unchanged.

Example request

{
  "rate": 10000
}

Response

OK

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
  }
}