generated: '2026-10-08'
method: derived
generator: derive-vocabulary.py
source: openapi/_original/hourtick-v1-openapi.json
vocabulary:
  name: Hourtick Domain Vocabulary
  description: 'Terms declared by Hourtick''s own API contract: its resource groups, objects and enumerations, with the contract''s definitions.
    Derived, not authored.'
  version: '2026-10-08'
  terms:
  - term: Account
    definition: Who you are and what you can track on.
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Notes and files
    definition: Documents and files on a client or a project. Everyone in the workspace can read and add them; the author or a manager deletes.
      Notes are Tiptap JSON with a plain-text copy (`text`); saves carry a `version` and a stale one answers 409.
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Time
    definition: Timers and time entries. Link time to a task with `workItemId` on start, create or edit.
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Tasks
    definition: 'The task board: tasks (work items), checklist, chat and files. Any member can create and edit.'
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Integrations
    definition: Your own accounts in Linear, Notion, Teamwork and Asana. Connecting needs a person's browser (OAuth); AI agents can't connect
      or link, and never post through a person's connection. Tokens are stored encrypted and never returned.
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Reports
    definition: Aggregated time and CSV.
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Billing
    definition: Usage (stored data plus data in and out this month) and extra usage. Every plan has unlimited people.
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Invoices
    definition: Invoices through the workspace's own Stripe account (Stripe Connect). An admin connects Stripe in Settings; Stripe Invoicing issues,
      emails and collects each invoice; Hourtick takes no fee (Stripe's own fees apply). Lines come from billable time not invoiced yet, and sent
      time is locked as invoiced. Agents send on their own only inside an invoice mandate; otherwise the invoice waits for an admin's
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Team
    definition: Approvals, invoicing and members (role-gated).
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Catalog
    definition: Clients, projects and task types (admins).
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Chat
    definition: 'Channels, DMs, threads, reactions, files and search. Message bodies are Markdown; reference things with links: `[#12 Title](hourtick://task/)`,
      `hourtick://project/`, `hourtick://client/`, `hourtick://entry/`, and mention with `[@Name](hourtick://user/)` or `hourtick://agent/`. `[@all](hourtick://user/all)`
      mentions everyone in a channel (not in DMs; managers and admins only beyond 50 people; peop'
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: Agents
    definition: '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:` in reports), never
      on'
    tags:
    - Resource Group
    source: openapi/_original/hourtick-v1-openapi.json
  - term: TimeEntry
    definition: Live duration = accumulatedSeconds + (now − timerStartedAt)/1000 while running.
    tags:
    - Object
    source: openapi/_original/hourtick-v1-openapi.json#/components/schemas/TimeEntry
  - term: WorkItem
    definition: 'A task. Status: todo | in_progress | review | done. Priority: 0 none … 4 urgent. `description` (in the detail and in writes)
      is Markdown, including `- [ ]` checklists.'
    tags:
    - Object
    source: openapi/_original/hourtick-v1-openapi.json#/components/schemas/WorkItem
  - term: Problem
    definition: 'Object declared by the contract with fields: type, title, status, detail, entry, conflicts.'
    tags:
    - Object
    source: openapi/_original/hourtick-v1-openapi.json#/components/schemas/Problem