Time Tracking Events API
POST /api/v1/features/:feature_id/time_tracking_events
Log time for a feature with remaining estimate
Example Request
POST /api/v1/features/1007868956/time_tracking_events
Example CURL command
curl "https://company.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": "6796021551475939872",
"user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"occurred_on": "2019-01-01",
"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
Example Request
POST /api/v1/features/1007868956/time_tracking_events
Example CURL command
curl "https://company.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": "6796021552426187638",
"user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"occurred_on": "2019-01-01",
"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
Example Request
POST /api/v1/features/1007868956/time_tracking_events
Example CURL command
curl "https://company.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": "6796021554699247927",
"user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"occurred_on": "2019-01-01",
"work_done": 5.0,
"work_units": 20
}
}
Example Request
POST /api/v1/requirements/483368544/time_tracking_events
Example CURL command
curl "https://company.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": "6796021555650584766",
"user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"occurred_on": "2019-01-01",
"work_done": 120.0,
"work_units": 10
}
}
Example Request
POST /api/v1/initiatives/423077122/time_tracking_events
Example CURL command
curl "https://company.aha.io/api/v1/initiatives/423077122/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": "6796021556525562584",
"user": {
"id": "1020675218",
"name": "Mary Humpty",
"email": "no-reply@aha.io",
"created_at": "2019-01-01T00:00:00.000Z",
"updated_at": "2019-01-01T00:00:00.000Z"
},
"occurred_on": "2019-01-01",
"work_done": 120.0,
"work_units": 10
}
}
Parameters
| Name | Description |
|---|---|
| id * | Numeric ID of the time tracking event to be deleted |
Example Request
DELETE /api/v1/time_tracking_events/447203384
Example CURL command
curl "https://company.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