Start CSV import of time entries
Enqueues a CSV import job. sourcePath must be an opaque upload path returned by POST /jobs/uploads. Required CSV columns: projectId, userId, date (ISO), hours. Optional: id (triggers update-in-place when updateInPlace=true), taskId, phaseId, notes. Review status is not importable — use the review endpoints, which require time_tracking:review. Reviewed time entries are immutable — update-by-id will reject them. hourlyRate and totalCost are recomputed server-side from labor rates.
Request
- Base URL: https://app.buildworkpro.com/api/v1
- URL: https://app.buildworkpro.com/api/v1/time-entries/imports
- Auth: HTTP bearer
Headers
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
Response
Job enqueued
Changes
No recorded changes to this operation across all 1 revision of this API.