---
title: "Book a time log"
method: POST
path: "/time_logs/{id}/book.json"
tags: ["Time logs"]
---

# Book a time log

`POST /time_logs/{id}/book.json`

## Path parameters

- `id` string, required

## Request body

- TimeBookingParams
  - `start` string, date-time
  - `stop` string, date-time
  - `user_id` integer
  - `project_id` integer
  - `activity_id` integer
  - `issue_id` integer
  - `comments` string

## Response `200`

time log found

- TimeBooking
  - `id` integer
  - `start` string, date-time
  - `stop` string, date-time
  - `time_log_id` integer
  - `time_entry_id` integer
  - `time_entry` TimeEntry
    - `id` integer
    - `author_id` integer
    - `user_id` integer
    - `project_id` integer, nullable
    - `issue_id` integer, nullable
    - `hours` string
    - `activity_id` integer
    - `comments` string, nullable
    - `spent_on` string, date
    - `tyear` integer
    - `tmonth` integer
    - `tweek` integer
    - `created_on` string, date-time
    - `updated_on` string, date-time
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — missing or wrong api key
- `403` — insufficient permissions
- `404` — nothing found

---

[API](https://skmtc.net/hicknhack-software/apis/hourglass-api.md) · [All operations](https://skmtc.net/hicknhack-software/apis/hourglass-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hicknhack-software/hourglass-api/versions/42cc6d20ab5d/schema)