About Services Tools Blog Contact us

Agent Time and Quote Access

A secure connection, offered as a standard web interface and as an assistant tool interface, so an assistant can read and write time entries, timers, companies, quotes and hour reports.

  • Agentic Workflows
  • Professional services
  • Tool
  • Product
  • Hybrid
  • 2026

The problem

Assistants could not log time or raise a quote unless a person clicked through the screens. Desktop assistants speak a tool protocol, which the REST paths do not, so a second door was needed.

What it does

A user profile issues an access key. The key is shown once and only a scrambled copy is stored. Each key is limited to reading, writing or deleting. The same underlying functions serve the standard connection and the assistant connection, so a key sees only the actions its permissions allow.

Outcomes

  • An assistant can start a timer, add an entry and draft a quote.
  • A read-only key cannot see the write tools.
  • Every change is recorded in an audit log and requests are rate limited.
  • One service layer sits behind both the REST API and the tool endpoint.

Simplified mockup

Interactive preview with sample data. Nothing is sent to a server.

Desk agent

agt_7k2m read
Token
NameDesk agent
Prefixagt_7k2m
SecretHidden
Stored hash9c1e4af0b71d
LimitOwn entries and timers

The issuer refuses plain HTTP. This preview does not call a live service. 120 requests a minute, 30 writes.

Ready to issue
Try a call

GET /me

No call yet

POST /entries

A write without write scope is refused
Tools this token can see
list_entriesread-only
hours_reportread-only

Tick Allow write to add start timer and create quote. A read token never receives those tools.

Hours this week

read scope
Hours
0
Amount
0
Clients
0
hours_report
ClientHoursRateAmount
North Quay Interiors10.0£125£1,250
Field & Lantern2.0£125£250
Reed Wharf Joinery4.0£110£440
Quote draft needs write

Field & Lantern, hallway fitting. Six and a half hours at £125, drawings included.

A read token can see the hours. Creating the quote is refused until write is allowed.

Audit and limits

Reads left this minute
116
cap 120
Writes left this minute
30
cap 30
Delete scope
Off
not on this token
api_audit_log
ActionScopeResult
issue_tokenreadhash stored
hours_reportread3 clients
Same service, two doors

REST routes and the tool list call one service. The tool list is filtered by scope, and each write lands in this log. The document of routes matches the tools above.

How it works

  1. Issue a key from the terminal, show it once, and store only a scrambled copy.
  2. Limit an ordinary key to its owner's own entries and timers.
  3. Offer entries, timers, companies, quotes, events and hour reports through the standard connection.
  4. List the same actions for assistants, marked as read-only or destructive and filtered by permission.
  5. Limit requests per minute and record every change in an audit log.
  6. Refuse to issue keys when asked over the web.

Pipeline

flowchart LR
  A[Token] --> B[Scope check]
  B --> C[REST route]
  B --> D[Tool list]
  C --> E[Time entry]
  D --> E
  E --> F[Audit log]