# HumanHours API

**Canonical:** https://apis.io/apis/humanhours-dev/humanhours-dev-api/  
**Provider:** HumanHours — https://apis.io/providers/humanhours-dev/  
**Documentation:** https://humanhours.dev/docs/api/track

HumanHours API is one of 2 APIs that [HumanHours](https://apis.io/providers/humanhours-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

HumanHours API as documented publicly: 13 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/reports/cost-saved` | GET /api/v1/reports/cost-saved |
| POST | `/api/v1/track` | POST /api/v1/track |
| GET | `/v1/reports/cost-saved` | GET /v1/reports/cost-saved |
| GET | `/v1/reports/export` | Same shape as time-saved but always emits CSV with a Content-Disposition: attachment header. |
| GET | `/v1/reports/leaderboard` | GET /v1/reports/leaderboard |
| GET | `/v1/reports/time-saved` | GET /v1/reports/time-saved |
| GET | `/v1/reports/usage` | Open to all plans. Returns the org's current period state. |
| GET | `/v1/task-types` | GET /v1/task-types |
| POST | `/v1/task-types` | POST /v1/task-types |
| DELETE | `/v1/task-types/{key}` | Archives a custom task type (soft delete). |
| POST | `/v1/task-types/{key}/override` | Override a built-in baseline for your workspace. |
| POST | `/v1/track` | Record a single agent task. |
| POST | `/v1/webhooks` | POST /v1/webhooks |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/humanhours-dev/openapi/_ae-authored/humanhours-dev-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/humanhours-dev/json-schema/humanhours-dev-post-v1-track-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/humanhours-dev/json-schema/humanhours-dev-post-v1-track-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/humanhours-dev/json-schema/humanhours-dev-get-v1-reports-usage-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/humanhours-dev/json-schema/humanhours-dev-get-v1-reports-cost-saved-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/humanhours-dev/json-schema/humanhours-dev-get-v1-reports-leaderboard-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/humanhours-dev/json-schema/humanhours-dev-get-v1-reports-time-saved-response-schema.json

## Other HumanHours APIs (1)

- [Companies API](https://apis.io/apis/humanhours-dev/companies-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/humanhours-dev/humanhours-dev-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/humanhours-dev/.
