find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/hourtick:hourtick-account-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Hourtick Account API
  version: 1.0.0
  description: 'The Hourtick REST API. Authenticate with a personal API token: create one in **Settings → API tokens**, then send `Authorization: Bearer ht_…`.


    All timer changes go through **POST /api/v1/commands**, the same endpoint the web and Mac apps use. Commands are idempotent per `commandId` (use a new UUID per action, reuse it to retry safely).


    Every response carries a `Server-Time` header (epoch ms). Errors use RFC 9457 problem details.'
servers:
- url: https://hourtick.com
security:
- bearer: []
tags:
- name: Account
  description: Who you are and what you can track on.
paths:
  /api/v1/bootstrap:
    get:
      tags:
      - Account
      summary: Current user, workspace, projects and task types
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                description: user, workspace, profile, clients, projects (with task types and billable flags), tasks, recent
        '401':
          description: Missing or invalid token
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
      operationId: getApiV1Bootstrap
      x-operation-id-source: derived
  /api/v1/search:
    get:
      tags:
      - Account
      summary: Search the workspace (the ⌘K palette)
      description: Tasks (by number, e.g. `#12`, or title), your own time entries (notes, project, task type), projects, clients, people and the channels you can see. A few of each, best matches first.
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          maxLength: 100
      responses:
        '200':
          description: '{ tasks, entries, projects, clients, people, channels }'
      operationId: getApiV1Search
      x-operation-id-source: derived
  /api/v1/workspaces:
    post:
      tags:
      - Account
      summary: Create a workspace
      description: A new workspace you own, with a starter client, project and task types. You stay where you are; switch to it with POST /api/v1/workspace/switch. Up to 20 owned workspaces; agents can't create them.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 80
      responses:
        '201':
          description: Created
        '409':
          description: You own the maximum number of workspaces
        '422':
          description: Invalid name
      operationId: postApiV1Workspaces
      x-operation-id-source: derived
  /api/v1/workspace/switch:
    post:
      tags:
      - Account
      summary: Move this signed-in device to another workspace you're a member of, and make it…
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                workspaceId:
                  type: string
                  format: uuid
              required:
              - workspaceId
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspaceId:
                    type: string
                  role:
                    type: string
        '404':
          description: Not a member
      operationId: postApiV1WorkspaceSwitch
      x-operation-id-source: derived
  /api/v1/connected-apps:
    get:
      tags:
      - Account
      summary: Apps you connected over OAuth (ChatGPT, Claude…).
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
      operationId: getApiV1ConnectedApps
      x-operation-id-source: derived
  /api/v1/connected-apps/{clientId}:
    delete:
      tags:
      - Account
      summary: 'Disconnect an app: its tokens stop working at once'
      parameters:
      - name: clientId
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Disconnected
      operationId: deleteApiV1ConnectedAppsByClientId
      x-operation-id-source: derived
components:
  schemas:
    Problem:
      type: object
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        entry:
          $ref: '#/components/schemas/TimeEntry'
        conflicts:
          type: array
          description: 'Bulk edits: entries that blocked the change.'
          items:
            type: object
            properties:
              id:
                type: string
              reason:
                type: string
    TimeEntry:
      type: object
      properties:
        id:
          type: string
          format: uuid
        workspaceId:
          type: string
          format: uuid
        userId:
          type: string
        projectId:
          type: string
          format: uuid
        taskId:
          type: string
          format: uuid
          description: Task type
        workItemId:
          type:
          - string
          - 'null'
          format: uuid
          description: The task this time is for, if any
        notes:
          type: string
        spentDate:
          type: string
          format: date
          description: The day the time belongs to (user's time zone).
        timezone:
          type: string
          examples:
          - Europe/Copenhagen
        accumulatedSeconds:
          type: integer
          description: Seconds banked from completed runs.
        timerStartedAt:
          type:
          - integer
          - 'null'
          description: Epoch ms when the current run started; null when stopped.
        billable:
          type: boolean
        lockedReason:
          type:
          - string
          - 'null'
          enum:
          - null
          - invoiced
          - approved
          - submitted
        version:
          type: integer
        deletedAt:
          type:
          - integer
          - 'null'
        createdAt:
          type: integer
        updatedAt:
          type: integer
      description: Live duration = accumulatedSeconds + (now − timerStartedAt)/1000 while running.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: ht_… personal API token