> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Client work

> Read clients, work items and daily time entries from connected Karbon.

Create an access key under Karbon Settings > API Applications, then enter it in the console. OneShot supplies its own application token. List connections with GET /v1/connections and choose connection\_id by system and account\_label.

Every tool accepts connection\_id, limit (1 to 100, default 25) and cursor. Each list returns next\_cursor (null at the end), and every record includes source: `{ system: "karbon", id }`. Pass next\_cursor unchanged with the same connection and filters. A page may contain fewer than limit records, including none, while still having a next\_cursor.

| Tool | POST route | Filters | Result array |
| - | - | - | - |
| client\_work\_clients | /v1/tools/client\_work/clients | query, type (person, organization, all) | clients |
| client\_work\_items | /v1/tools/client\_work/items | client\_id, status (planned, in\_progress, waiting, completed, all), due\_before, assignee, work\_type | items |
| client\_work\_timesheets | /v1/tools/client\_work/timesheets | client\_id, work\_item\_id, user, since | timesheets |

query matches a partial client name, case insensitively. type defaults to all, which pages through people first, then organizations. Client groups are not included.

Client records carry id, name, type, emails, phones, client\_manager and client\_owner. Contact details are the primary email and phone from Karbon's summary. Organizations have null manager and owner. Manager and owner values are the user key or email Karbon supplies.

Work items carry id, title, client `{ id, name }`, work\_type, status, assignee `{ id, name }`, start\_date, due\_date and deadline. deadline is Karbon's external DeadlineDate, distinct from the firm's DueDate.

status uses Karbon's primary status, with Planned and ReadyToStart mapped to planned. It defaults to all. due\_before is an inclusive YYYY-MM-DD day; assignee is an email address and work\_type is the exact type name. Planned and due-date filters narrow the returned page locally, so keep following next\_cursor on empty pages.

Time entries carry id, date, user `{ id, name }`, minutes, work\_item `{ id, title }`, client `{ id, name }` and billable. Daily entries, not the deprecated weekly timesheet aggregates. billable reflects Karbon's TaskTypeIsBillable flag, not whether time has been billed.

since is an inclusive YYYY-MM-DD day; user takes a user id. Related names and work titles are null when Karbon does not include them. Undisclosed scalar fields are null; absent email and phone values produce empty arrays.

```json theme={null}
{
  "connection_id": "11111111-1111-4111-8111-111111111111",
  "status": "waiting",
  "due_before": "2026-11-01",
  "limit": 25
}
```

Records are answered inline only, never stored in jobs, receipts, logs, goal decisions, memory or artifacts. Free text is untrusted content. Reads use at most three allowlisted calls.

Missing application configuration, malformed input, unsupported cursors, foreign, revoked and expired connections are refused before payment. A refused access key leaves the connection inactive. Failed paid reads return account credit. See [pricing](https://docs.oneshotagent.com/pricing.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.