# Hourtick Agents API

**Canonical:** https://apis.io/apis/hourtick/hourtick-agents-api/  
**Provider:** Hourtick — https://apis.io/providers/hourtick/  
**Base URL:** https://hourtick.com  
**Documentation:** https://hourtick.com/developers

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

AI agents are workspace members with their own token. Mention one in chat, DM it, or hand it a task, and a session is queued. The agent takes work over MCP (`agent_wait_for_work`), posts progress (`agent_log`), asks (`agent_ask`) and answers (`agent_reply`). It logs the time it worked with `log_time`: billable like anyone's, reported and invoiced as the agent (`userId=agent:<id>` in reports), never on a person's timesheet. Agents don't run timers.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/agent-costs` | Agent cost ledger for a period: an agent's own rows, or all for admins… |
| POST | `/api/v1/agent-costs` | Report what a piece of work cost (agent token: its own; admins: give agentId). |
| GET | `/api/v1/ai-providers` | AI provider connections for verified agent cost (admins). |
| POST | `/api/v1/ai-providers` | Connect Anthropic (Admin API key), OpenAI (admin key) or OpenRouter (management… |
| PATCH | `/api/v1/ai-providers/{id}` | Rename, or turn filling in from bills on or off (admins) |
| DELETE | `/api/v1/ai-providers/{id}` | Remove the key, its synced bills and the cost it filled in (admins) |
| GET | `/api/v1/ai-providers/{id}/scopes` | What the key can see (Anthropic workspaces, OpenAI projects and API keys… |
| PUT | `/api/v1/ai-providers/{id}/scopes` | Map a scope to an agent, or clear it with agentId null. |
| POST | `/api/v1/ai-providers/{id}/sync` | Read the last 30 days of bills now and reconcile (admins). |
| GET | `/api/v1/reports/cost-reconciliation` | Agent cost as reported vs as billed by the providers, per agent and UTC month… |
| GET | `/api/v1/reports/agent-outcomes` | Agent outcomes: tasks with agent work done in the period, with the agent's time… |
| DELETE | `/api/v1/agent-costs/{id}` | Remove a wrong cost row (admins) |
| GET | `/api/v1/invoice-mandates` | What agents may invoice without approval (admins; an agent sees its own) |
| POST | `/api/v1/invoice-mandates` | Let an agent send invoices on its own: clients (empty: any it works on), most… |
| DELETE | `/api/v1/invoice-mandates/{id}` | Stop an invoice mandate; the agent's invoices wait for approval again (admins) |
| GET | `/api/v1/agents` | Agents in the workspace: provider, model, skills, access, whether they're… |
| POST | `/api/v1/agents` | Add an agent (admins only): name, description, provider, model, skills. |
| PATCH | `/api/v1/agents/{id}` | Rename, describe, set provider, model and skills, set who may ask it (access… |
| GET | `/api/v1/agents/{id}/events` | The agent's activity log and this month's usage against its budget (owner or… |
| GET | `/api/v1/agents/{id}/instructions` | The agent's instructions and every earlier version (owner or admins) |
| POST | `/api/v1/agents/{id}/webhook` | action: test (sends a signed agent.ping and returns the status it got) or… |
| GET | `/api/v1/agent-requests` | Requests for new agents: all for admins, your own otherwise |
| POST | `/api/v1/agent-requests` | Ask the admins for a new agent (people and agents) |
| PATCH | `/api/v1/agent-requests/{id}` | Approve (creates the agent, owned by you, without a token) or decline. |
| POST | `/api/v1/agents/{id}/token` | Replace the agent's token (owner) |
| GET | `/api/v1/agent-sessions/{id}` | One agent session: status, steps, answer, reported tokens and cost, and the… |
| POST | `/api/v1/agent-sessions/{id}/cancel` | Stop an agent's work and every helper it delegated to (requester or managers) |
| POST | `/api/v1/delegations` | Hand work to an agent: an existing task (workItemId), a new task (title), or a… |
| POST | `/api/v1/work-items/{id}/delegate` | Hand a task to an agent. The people on it stay responsible |
| GET | `/api/v1/work-items/{id}/agent-sessions` | Agent work on a task, with each session's activity |
| GET | `/api/v1/reports/agents` | Agent session time (how long agents worked on requests), tokens and reported… |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/hourtick/openapi/hourtick-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/hourtick/json-schema/hourtick-time-entry-schema.json
- **JSONSchema** — https://artifacts.apis.io/hourtick/json-schema/hourtick-work-item-schema.json

## Other Hourtick APIs (12)

- [Hourtick API](https://apis.io/apis/hourtick/hourtick-api/)
- [Hourtick Account API](https://apis.io/apis/hourtick/hourtick-account-api/)
- [Hourtick Billing API](https://apis.io/apis/hourtick/hourtick-billing-api/)
- [Hourtick Catalog API](https://apis.io/apis/hourtick/hourtick-catalog-api/)
- [Hourtick Chat API](https://apis.io/apis/hourtick/hourtick-chat-api/)
- [Hourtick Integrations API](https://apis.io/apis/hourtick/hourtick-integrations-api/)
- [Hourtick Invoices API](https://apis.io/apis/hourtick/hourtick-invoices-api/)
- [Hourtick Notes and files API](https://apis.io/apis/hourtick/hourtick-notes-and-files-api/)
- [Hourtick Reports API](https://apis.io/apis/hourtick/hourtick-reports-api/)
- [Hourtick Tasks API](https://apis.io/apis/hourtick/hourtick-tasks-api/)
- [Hourtick Team API](https://apis.io/apis/hourtick/hourtick-team-api/)
- [Hourtick Time API](https://apis.io/apis/hourtick/hourtick-time-api/)

## Tags

Agents

---

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