TimeEntries

Create time entry

post/time-entries

Request

  • Base URL: https://app.buildworkpro.com/api/v1
  • URL: https://app.buildworkpro.com/api/v1/time-entries
  • Auth: HTTP bearer

Headers

Idempotency-Keystring uuid

Idempotent retry key for mutating operations. The first request with a given key executes normally and BuildWorkPro caches the response. Replaying the same key with the same request body (method + path + JSON body, SHA-256 hashed) returns the cached response without re-executing the mutation. Replaying with a DIFFERENT body returns 409 idempotency_key_reused. The cache TTL is 24 hours; after expiry the key is treated as a new operation. Keys are tenant-scoped. Recommended: a fresh UUID v4 per logical operation.

Request body

userIdinteger required
projectIdinteger required
taskIdinteger nullable
phaseIdinteger nullable
datestring required

Calendar day, YYYY-MM-DD. A datetime is accepted and read as the day it names.

hoursnumber required
notesstring nullable
entryTypestring
clockInstring nullable
clockOutstring nullable
latnumber nullable
lngnumber nullable
clockInAccuracyMnumber nullable
clockOutLatnumber nullable
clockOutLngnumber nullable
clockOutAccuracyMnumber nullable
clientIdstring uuid nullable

Optional idempotency key (a UUID the client mints once per queued create and repeats on every retry). A repeat with the same key from the same user returns the existing record with 200 instead of creating a duplicate.

Response

Replay of an earlier create with the same clientId — the existing time entry, unchanged

Changes

No recorded changes to this operation across all 1 revision of this API.