API Docs / Operations / Users / Change User Rate

Change User Rate

POST /tenants/{tenant}/users/{userCode}/rates

Changes the user's current rates. With preserveHistory the current entry is closed the day before effectiveFrom and a new current entry begins; without it the current entry is corrected in place. Either way, rates already stamped on logged time entries are never changed. Setting a cost rate requires the Cost Rates permission.

Parameters

NameTypeDescription
tenant* path string

The Tenant.Code

The Tenant.Code

userCode* path string
{
  "hourlyRate": 0,
  "costRate": 0,
  "preserveHistory": false,
  "effectiveFrom": "2024-01-01"
}

Responses

400 Bad Request
401 Unauthorized – Invalid or missing API key
403 Forbidden
404 Not Found