Time Tracking Events API

POST /api/v1/features/:feature_id/time_tracking_events

Log time for a feature with remaining estimate

POST /api/v1/features/1007868956/time_tracking_events

Example CURL command 

curl "https://account1.aha.io/api/v1/features/1007868956/time_tracking_events" -d '{"time_tracking_event":{"user_id":689956296,"work_done_text":"1h 30min","remaining_estimate_text":"2h"}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request 

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "time_tracking_event": {
    "user_id": 689956296,
    "work_done_text": "1h 30min",
    "remaining_estimate_text": "2h"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "time_tracking_event": {
    "id": "6580369217694908538",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "mary.humpty@account1.com",
      "created_at": "2018-07-20T18:31:42.000Z",
      "updated_at": "2018-07-20T18:31:42.000Z"
    },
    "occurred_on": "2018-07-20",
    "work_done": 90.0,
    "work_units": 10
  }
}

POST /api/v1/features/:feature_id/time_tracking_events

Log time for a feature auto update remaining estimate

POST /api/v1/features/1007868956/time_tracking_events

Example CURL command 

curl "https://account1.aha.io/api/v1/features/1007868956/time_tracking_events" -d '{"time_tracking_event":{"user_id":689956296,"work_done_text":"1h 30min"}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request 

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "time_tracking_event": {
    "user_id": 689956296,
    "work_done_text": "1h 30min"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "time_tracking_event": {
    "id": "6580369219078829883",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "mary.humpty@account1.com",
      "created_at": "2018-07-20T18:31:42.000Z",
      "updated_at": "2018-07-20T18:31:42.000Z"
    },
    "occurred_on": "2018-07-20",
    "work_done": 90.0,
    "work_units": 10
  }
}

POST /api/v1/features/:feature_id/time_tracking_events

Log time for a feature that uses story points

POST /api/v1/features/1007868956/time_tracking_events

Example CURL command 

curl "https://account1.aha.io/api/v1/features/1007868956/time_tracking_events" -d '{"time_tracking_event":{"user_id":689956296,"work_done_text":"5p","remaining_estimate_text":"20p"}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request 

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "time_tracking_event": {
    "user_id": 689956296,
    "work_done_text": "5p",
    "remaining_estimate_text": "20p"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "time_tracking_event": {
    "id": "6580369221122891653",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "mary.humpty@account1.com",
      "created_at": "2018-07-20T18:31:42.000Z",
      "updated_at": "2018-07-20T18:31:42.000Z"
    },
    "occurred_on": "2018-07-20",
    "work_done": 5.0,
    "work_units": 20
  }
}

POST /api/v1/requirements/:requirement_id/time_tracking_events

Log time for a requirement

POST /api/v1/requirements/483368544/time_tracking_events

Example CURL command 

curl "https://account1.aha.io/api/v1/requirements/483368544/time_tracking_events" -d '{"time_tracking_event":{"user_id":689956296,"work_done_text":"2h"}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request 

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "time_tracking_event": {
    "user_id": 689956296,
    "work_done_text": "2h"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "time_tracking_event": {
    "id": "6580369222654134440",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "mary.humpty@account1.com",
      "created_at": "2018-07-20T18:31:42.000Z",
      "updated_at": "2018-07-20T18:31:42.000Z"
    },
    "occurred_on": "2018-07-20",
    "work_done": 120.0,
    "work_units": 10
  }
}

DELETE /api/v1/time_tracking_events/:id

Delete a time tracking event

Parameters

Name Description
id * Numeric ID of the time tracking event to be deleted

DELETE /api/v1/time_tracking_events/447203384

Example CURL command 

curl "https://account1.aha.io/api/v1/time_tracking_events/447203384" -d '' -X DELETE \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request 

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json

Response 

Status: 204 No Content

Overview

API Resources