Time tracking
Manual Task time entries, Workspace rounding policy, and personal timesheets.
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Header Parameters
string·min 43·max 43Session-bound CSRF token. It must exactly match the
__Host-assign_csrf cookie sent with the request.
string·min 16·max 200Opaque client-generated key for safely retrying this operation.
Request Body
Responses
stringQuoted decimal optimistic-concurrency version.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List live time entries for a Task in a bounded revision-fenced collection
/api/v1/tasks/{task_id}/time-entriesPath Parameters
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
stringWorkspace report snapshot revision. Compare across every page and all four Project time reads in one selected range; restart the entire range after a mismatch. The value may advance for unrelated Workspace writes.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Header Parameters
Request Body
Responses
stringQuoted decimal optimistic-concurrency version.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
stringCommitted Workspace time report revision for comparing Task entries and totals.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
stringWorkspace report snapshot revision. Compare across every page and all four Project time reads in one selected range; restart the entire range after a mismatch. The value may advance for unrelated Workspace writes.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List a Project's recorded time grouped by Task
/api/v1/projects/{project_id}/time-task-breakdownGroups entries by captured Project attribution. Missing Task metadata does not remove historical totals. Pages are ordered by Task ID and must be recaptured from the beginning after a realtime invalidation. The signed continuation is bound to the Workspace, Actor, Project and date range.
Path Parameters
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
stringWorkspace report snapshot revision. Compare across every page and all four Project time reads in one selected range; restart the entire range after a mismatch. The value may advance for unrelated Workspace writes.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List recorded entries for one Task in a Project report
/api/v1/projects/{project_id}/time-task-entriesProject managers only. Uses the Project captured when each entry was recorded, even if the Task has moved. Pages are ordered by entry ID and must be recaptured from the beginning after a realtime invalidation. The signed continuation is bound to Workspace, Actor, Project, Task and selected range.
Path Parameters
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
stringWorkspace report snapshot revision. Compare across every page and all four Project time reads in one selected range; restart the entire range after a mismatch. The value may advance for unrelated Workspace writes.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List a Project's recorded time grouped by contributor
/api/v1/projects/{project_id}/time-contributor-breakdownReturns identity-level rows to Project managers and an empty redacted result to other authorized Project readers. Historical Actor attribution is retained when a user is removed; unavailable display names are null. Pages are ordered by Actor ID and must be recaptured from the beginning after a realtime invalidation. The signed continuation is bound to the Workspace, Actor, Project and date range.
Path Parameters
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
stringWorkspace report snapshot revision. Compare across every page and all four Project time reads in one selected range; restart the entire range after a mismatch. The value may advance for unrelated Workspace writes.
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Header Parameters
string·min 43·max 43Session-bound CSRF token. It must exactly match the
__Host-assign_csrf cookie sent with the request.
string·min 16·max 200Opaque client-generated key for safely retrying this operation.
Request Body
Responses
stringQuoted decimal optimistic-concurrency version.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Path Parameters
Header Parameters
string·min 43·max 43Session-bound CSRF token. It must exactly match the
__Host-assign_csrf cookie sent with the request.
string·min 16·max 200Opaque client-generated key for safely retrying this operation.
Responses
stringQuoted decimal optimistic-concurrency version.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
string <uuid>Opaque Assign-owned UUIDv7 identifier. Clients must not derive meaning from it.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
List the caller's time entries in a date range
/api/v1/timesheets/meReturns up to 100 entries per page with stable totals for the selected range. Follow next with the same range and limit. A changed report revision refuses continuation; ranges over 800 entries return 413 at the retained limit.
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
stringSnapshot revision shared by every page of the selected personal timesheet.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.
Export the caller's time entries as CSV
/api/v1/timesheets/me/exportExports one consistent selected range of at most 800 entries; a larger range returns 413.
Query Parameters
Header Parameters
stringUpcoming browser-session canonical read. Set to '1' to capture the authorized response and a signed Workspace replay cursor in one snapshot. Apply every required retained read before acknowledging a socket checkpoint. Failed or incomplete reads return no cursor.
1Responses
string·max 4096Signed Workspace/User/session-bound replay custody; present only after a successful requested canonical baseline.
stringDecimal-string snapshot position; present only with a successful baseline cursor.
integer·min 0Delay in seconds before retrying, when an expected maintenance end is known.
string·const no-storePrevents storage of error responses by clients and intermediaries.
string·min 1·max 200Correlation identifier for the request.
string·const nosniffPrevents user agents from MIME-sniffing the response.